Help
Getting started.
Getting started
How do I get started with Softlight?
An installation is a separate Minecraft setup with its own version, loader, mods, settings, and worlds. Start with one simple installation before adding a large pack.
- Download Softlight for your operating system and install it.
- Open Softlight. Use the account control to add the Microsoft account that owns Minecraft: Java Edition.
- In Library, choose New installation. Pick a custom setup, find a modpack, or import a pack file.
- Choose the Minecraft version and loader, then let Downloads finish preparing the files and Java runtime.
- Select the installation and use Play. If sign-in or launch fails, keep the error message and use the troubleshooting topics below.
What does Softlight do?
Softlight is an independent launcher for Minecraft: Java Edition. It organizes separate game installations, downloads compatible content, manages local dedicated servers, and provides tools for files, logs, screenshots, skins, and Java.
The installed app performs these tasks on your computer. The website provides downloads, release notes, documentation, and a handoff for private invitations. Softlight does not include a Minecraft license and is not an official Mojang or Microsoft product.
Link to answerWhich computers can run Softlight?
Softlight is available for Windows 10 and 11 x64, Linux x86_64, and macOS 13 or later. The universal macOS download includes Intel and Apple Silicon. The macOS app is not notarized, and Apple Silicon hardware checks are still pending. See the Download page for Linux requirements and installation instructions.
There is no Android or iOS app. The website works on phones and tablets. Game performance and memory needs depend on your Minecraft version, mods, shaders, and server workload.
Link to answerWhich Minecraft versions and loaders are supported?
Client installations support Minecraft: Java Edition release versions with Vanilla, Fabric, Forge, NeoForge, and Quilt. The loader choices come from the compatible versions available for your selected Minecraft release.
Bedrock Edition and snapshots are not supported by this launcher. A mod built for one loader is not automatically compatible with another. Dedicated servers have additional engine choices, including Paper and Purpur.
Link to answerHow do I install or reinstall the Windows app?
Use the installer linked on the Download page. Close active games, servers, and sharing sessions before replacing or updating the launcher. Keep a backup of worlds you want to preserve.
Current installers are unsigned, so Windows can show an unknown-publisher warning. Check that the file came from the official download page and that its checksum matches. A matching checksum checks file integrity; it does not provide Windows code signing. Do not turn off system protection just to dismiss a warning.
Link to answerHow do I check the installer's SHA-256?
On the Download page, copy the SHA-256 value beside the installer. In PowerShell, use Get-FileHash on the downloaded file with -Algorithm SHA256, then compare the entire resulting hash with the website value.
The Download checksums link provides a checksum manifest when one is published. If the values differ, discard that download and download it again. Do not run a mismatched file. Compare against the release you actually downloaded, because a newer release has a different hash.
Link to answerCan I play Minecraft or manage my files in the browser?
Use the desktop app to launch Minecraft, manage local files, run servers, or apply skins. The launcher image on the homepage is a screenshot.
The website provides downloads, content discovery, updates, and help. It cannot read or change the installations on your computer.
Link to answerAccounts
Why do I need a Microsoft account?
Playing Minecraft: Java Edition requires its normal Microsoft sign-in and ownership checks. Softlight opens Microsoft's sign-in in your system browser; you do not type your Microsoft password into the launcher.
Local server management and Softlight's private sharing invitations do not require a separate Softlight account. These features do not remove Minecraft's own login requirements.
Link to answerHow do I add a Minecraft account?
Open the account control near the bottom of the sidebar, then choose Add Microsoft account. Complete sign-in in the browser and return to Softlight.
Use a personal Microsoft account with a Minecraft: Java Edition profile. The launcher must complete the Microsoft, Xbox, ownership, and Minecraft profile steps before the account is ready. Keep the account dialog open to see any failure message.
Link to answerCan I save and switch between multiple accounts?
The account manager can save up to 20 Minecraft profiles. Select a saved profile to make it active for subsequent actions and launches. The active profile is marked in the list.
A game that is already running keeps the session it was launched with. Switching the launcher account does not replace that game's session. Accounts that need authentication remain listed with a Sign in again action.
Link to answerWhat happens when I remove a saved account?
Removal deletes that account's saved sign-in from this device. It does not delete your Microsoft account, installations, worlds, or a running game.
Softlight asks for confirmation. Removing the final saved account deletes the launcher's account vault. Add the account again through Microsoft if you want to use it later.
Link to answerWhy does Microsoft sign-in fail after the browser returns?
The browser returning successfully does not mean every Minecraft authentication step succeeded. The account dialog keeps the error so you can identify the failing stage.
MC_APP_REGISTRATION means the Minecraft service explicitly rejected the application's registration. An HTTP 403 alone does not identify the cause. A generic MC_MINECRAFT_FORBIDDEN does not by itself prove that you lack a license.
At the time this guide was checked, Softlight's Minecraft AppID approval was pending. Updating the launcher cannot grant that approval.
- Check that you selected the intended Microsoft account and that it has a Java Edition profile.
- Use the latest published Softlight build, then retry once through the account manager.
- Keep the safe error code and your launcher version if you report the problem. Never include passwords, tokens, or a raw credential file.
Can I cancel a pending sign-in?
Yes. The account manager offers Cancel sign-in while it waits for Microsoft. You can close and reopen the dialog to check a pending attempt.
Cancelling an account addition does not replace the active account. If the browser still shows an old sign-in tab, close it and start a new attempt from the launcher when you are ready.
Link to answerWhat does Sign in again mean?
The saved profile is known, but Softlight cannot currently use its session. Select Sign in again in the account manager and finish authentication in the browser.
Do not delete your game installation to repair a login problem. Worlds and game files are separate from saved credentials.
Link to answerInstallations
How do I create a custom installation?
Choose Library > New installation and select the custom setup option. Name the installation, choose a Minecraft release, and select Vanilla or a compatible mod loader.
The loader version list follows the selected game version. If no compatible loader is available, choose another supported combination. Preparation runs through Downloads; an interrupted installation must finish successfully before it can launch.
Link to answerHow do Library groups work?
Use New group beside Library search. An installation's actions menu lets you move it to a group or back to Ungrouped. Groups can be renamed, collapsed, and removed.
Removing a group does not delete its installations or game files. Groups are flat, with no nested groups or drag-and-drop organization. New, imported, and duplicated installations start in Ungrouped.
Link to answerCan I search, sort, or switch the Library layout?
Library provides search, sorting, and grid/list views. Search temporarily reveals matching installations even when their group is collapsed.
The selected grid/list layout, group membership, and collapsed groups persist. Open an installation from its card or list row; its action controls remain available for operations such as moving or duplicating it.
Link to answerWhen should I duplicate an installation?
Use Duplicate from the installation's actions or Settings before trying a different setup. The copy is a separate Library entry, so you can experiment without editing the original installation's files.
Stop the installation and finish its downloads first. A duplicate uses additional disk space and is not a substitute for an independent backup of important worlds.
Link to answerDoes deleting an installation delete its worlds?
Yes. The confirmation covers the installation and its local files, including worlds, mods, and configuration. Copy out anything you want to keep before confirming.
Deleting a Library group or clearing finished download history is different: those actions do not delete installation files. A running or installing profile must be stopped before deletion.
Link to answerWhere are my worlds and settings?
Each installation has its own game directory. Worlds are in saves, mods in mods, and mod configuration usually in config. Screenshots and logs also belong to that installation.
Use Open folder or the installation's Files tab to inspect the right setup. Stop the game before copying a world or editing its files. Back up worlds before changing Minecraft versions or removing mods that add world content.
Link to answerCan I change an installation or server picture?
Use the picture control in the installation or server header. Choose picture accepts a local PNG, JPEG, or WebP. You can return to the Softlight logo, or restore imported pack artwork where available.
The app creates a normalized local image without modifying the original. The picture is reused in the Library, detail view, and related app controls. It does not change Minecraft's server-icon.png or upload your picture.
Link to answerHow do I find or stop a running game?
The title bar includes running-game controls that can open the relevant installation or stop its process. The normal Play and stop controls remain associated with that installation.
Settings > Game defaults includes Close launcher when the game starts. Active servers and sharing have their own lifecycle, so keep Softlight running while friends use a shared session.
Link to answerModpacks
Can I bring my own modpack?
Yes. Softlight imports Modrinth .mrpack files and CurseForge modpack ZIPs. The archive must be a supported pack with a valid manifest, not an arbitrary ZIP of someone else's game directory.
- Open Library > New installation and choose the local pack import option.
- Select the .mrpack or CurseForge ZIP file.
- Follow the named task in Downloads while Softlight reads the manifest, prepares the game, and downloads content.
- Open the new installation from Library when preparation succeeds.
How do I find a modpack inside Softlight?
Choose the modpack search option in New installation, or open Browse and select Modpacks. Switch between the available providers, inspect a project, and choose a compatible pack version.
A pack creates its own installation with the author's configuration. It is not applied over an unrelated existing profile.
Link to answerCan I double-click or drag a pack into the app?
The Windows installer registers .mrpack files with Softlight. Double-click one, or use Windows Open with if another launcher is already your default.
You can drop up to ten supported pack files onto the launcher. Startup, an open dialog, or unsaved edits may delay handling until you resolve them. Original pack files are not moved or deleted. Dropping files inside the file manager copies them into the current folder instead.
Link to answerWill updating a modpack overwrite my existing world?
Changing a linked pack's version creates a new installation. The original installation, worlds, and settings remain in the original folder.
Open the linked pack's version browser from its installation header. Before copying a world into the new version, make a separate backup and check the pack author's upgrade instructions. A newer pack may remove mods or change world data.
Link to answerIs there a modpack size limit?
Pack imports do not impose the old fixed archive, extracted-size, file-count, or download-size caps. Large ZIP and ZIP64 archives are processed in streams.
You still need enough disk space and system resources for the archive, extracted files, downloads, and installation. Keep room for Java, shared game resources, and backups too. A large download that is still making progress is different from a stalled transfer.
Link to answerWhat are overrides and optional files?
Pack authors can include configuration and other override files. Softlight copies supported overrides into the new installation so it starts with the author's setup.
Optional client files default to omitted. The pack's declared Minecraft and loader versions matter: Softlight checks compatible loader pins and does not silently replace them with a different version. Required file hashes still have to match even when an author supplied an inaccurate file-size estimate.
Link to answerWhat should I do if a modpack import fails?
Open the failed task in Downloads and read the specific error before retrying. Common causes include a missing provider file, a restricted download, an unavailable loader version, an invalid archive, or insufficient disk space.
- Check the pack's required Minecraft version and loader.
- Check free space and confirm the archive came from its official project page.
- Use Retry for a failed task after resolving the cause. Keep the original source archive available.
- For a checksum or archive-validation failure, download the source again. Do not bypass validation or replace a pinned dependency at random.
Can I import a whole folder from another launcher?
Importing another launcher's complete instance directory is not a supported pack-import format. Use a proper Modrinth or CurseForge pack export when one is available.
For a manual migration, create a matching installation, stop it, and copy only the game files you understand through its folder or file manager. Preserve a separate copy of the source world and configuration. Copying files does not recreate provider records or validate all dependencies.
Link to answerMods & content
Where do mods come from?
Softlight browses Modrinth and CurseForge and downloads files from their original distribution sources. It does not rehost mods. Provider and file-version records identify the source of tracked content.
Choose the target installation before installing. Minecraft version, loader, content type, and provider restrictions all affect what can be installed.
Link to answerHow do I install a mod from Browse?
Select the installation, open Browse, and choose Mods. Search for the project and check the selected Minecraft version and loader.
Install chooses a compatible provider release. Straightforward additions can install immediately; updates, dependencies, warnings, and conflicts open a review. Open the project's title or artwork to inspect details and choose a version yourself.
Link to answerWhat does the dependency review mean?
Some projects require other files or conflict with an installed selection. The review shows what will be added or replaced, plus optional choices and blocking conflicts.
An enabled file already installed at the exact required provider version can be reused. Metadata warnings for unchanged pack files are not proof of runtime compatibility. New incompatible requirements still block installation. Softlight does not silently downgrade a pack to make a plan fit.
Link to answerDo I need my own CurseForge API key?
Current installed releases use Softlight's bundled application access. They no longer offer a personal provider-key form, and retired personal-key files do not override that access.
If CurseForge is unavailable, check your launcher version, connection, and the displayed provider error. Do not paste an API key into a help request or download a key from another launcher. Provider access still does not override an author's file restrictions.
Link to answerHow do I find content already installed in a profile?
Open the installation's Content tab. It provides All, Mods, Resource Packs, and Shaders views, plus search, source filters, natural name sorting, and enabled/disabled mod filters.
Search also considers filenames and versions. Refresh rereads relevant folders and updates tracked mod information. Filters stay selected during the current navigation session but are not saved across app restarts. Files without an identified provider appear as Local / unidentified.
Link to answerCan I import, disable, or remove a local JAR?
Use the mod import action to select a local .jar file, or inspect the installation's Content controls for enable, disable, and removal actions. Stop the game and finish conflicting downloads before changing its files.
Local JARs are tracked by hash. Softlight cannot infer all their dependencies or guarantee that they match your loader. Mods execute code when Minecraft starts, so use sources you trust. Removing a mod that adds blocks or world data can affect a saved world.
Link to answerHow do I install and activate resource packs?
In Browse, select Resource Packs and the target installation. Compatibility follows Minecraft version rather than the installation's mod loader. Review the destination and install the chosen file.
The file goes into resourcepacks. Enable it inside Minecraft afterward; Softlight does not change the game's activation settings. The installed-content view can show ZIP files and valid unpacked directories, but that view's resource-pack listing is read-only.
Link to answerHow do shaders work?
Choose Shaders in Browse and select the target installation. Downloaded shader packs go into shaderpacks, and you choose the active shader in Minecraft.
A shader pack may need a compatible shader loader already installed as a mod. A platform warning is not a promise that the loader is present. A missing dependency of another content type cannot always be installed in the same transaction; prepare it separately and review again.
Link to answerWhy must I choose a world for a data pack?
Data packs belong to a particular save. Select an existing local world during review so Softlight can install into that world's saves/<world>/datapacks folder.
The launcher uses the provider's data-pack release rather than a similarly named JAR variant. It does not change the world's activation settings automatically. Stop the game and back up the world before changing its data packs.
Link to answerHow are versions, updates, and disabled mods handled?
Browse indicates Install, Installed, or Update for the selected installation and, for data packs, the selected world. Release filters let you consider release, beta, or alpha files; inspect a project's versions when you need a specific one.
Quick installation uses compatible provider publication dates. It does not automatically downgrade a newer installed release. Updating a disabled mod through review enables it and shows a warning. Missing tracked files can be installed again. Bulk updating all content is not included.
Link to answerJava
Do I need to install Java myself?
Usually not. Automatic selects the runtime required by the Minecraft metadata and server engine. A missing managed runtime is prepared through a cancellable Downloads task before launch.
Softlight keeps these runtimes in its own data directory and does not replace system Java or edit PATH. Already installed managed runtimes can be reused without contacting the runtime download API.
Link to answerWhich Java runtimes can I manage?
Settings > Java runtimes lists managed Eclipse Temurin Java 8, 17, 21, and 25. Each has an Install control; Install all prepares the missing versions.
The installer does not bundle all four distributions. Runtime downloads appear in Downloads. Installing another runtime does not restart a running game or server. Automatic selection is normally the best starting point for a particular Minecraft version.
Link to answerCan I select a Java version or my own executable?
Installation and server settings offer Automatic, compatible managed versions, and Custom executable. A client installation can also inherit the game default. Save your selection; it applies to the next launch.
Use a real java.exe path for a custom runtime. Versions below the requirement are rejected, and Forge or NeoForge may require the exact expected major. A newer Java version is not always the right choice for an older modpack.
Link to answerHow much memory should I allocate?
Use the installation's Settings to adjust its memory allocation. Server memory is configured separately, and Settings > Game defaults provides a starting value for new installations.
Follow the pack or server author's requirements and leave memory for Windows and other apps. Allocating all available RAM can make the system less responsive. If a game reports an out-of-memory error, check its log and workload before changing several settings at once.
Link to answerDo game defaults change every existing installation?
Game defaults are the starting settings applied to new installations. Existing installations have their own memory settings and Java choices. A profile explicitly set to inherit the Java default follows that selection.
Appearance and download concurrency are separate settings. Save game-default changes with Save changes; appearance choices save immediately.
Link to answerMy game will not start. What should I check?
Open the installation's Latest log and Console. The first useful error and its surrounding lines are usually more informative than the final crash message.
- Confirm that the installation finished preparing and that no required download failed.
- Check that Minecraft version, loader, mods, and dependencies match.
- Try Automatic Java and a sensible memory allocation for the pack.
- Use Sign in again if the error concerns authentication rather than game files.
- Test changes in a duplicate installation and keep backups of worlds. Share a reviewed log if you need help.
Downloads & updates
Where do I see download progress?
Open Downloads or the title-bar Tasks control. Jobs identify their pack, installation, or server and show queued, running, completed, failed, or cancelled states.
Supported content tasks expand into per-file progress. A pack's total file sizes may be estimates, so progress can change as the launcher learns the actual transfer sizes. Java preparation also appears as a task.
Link to answerCan I change how many files download at once?
Open Settings > Downloads and set Concurrent content downloads from 1 to 10. The default is 8 unless you already saved another value.
Modrinth, CurseForge, pack content, and server content share the limit. Reducing it can help on a constrained connection; increasing it does not guarantee that a provider or your disk will become faster.
Link to answerCan I pause, cancel, or retry a download?
Cancel stops active and queued work for that task. Failed tasks can be retried after you address the cause. Pause and resume are not supported.
Transient network failures receive bounded automatic retries. Authentication errors, invalid metadata, and checksum failures are not repeatedly retried as if they were temporary connection problems. A transfer times out after five minutes without progress, not after five minutes of active downloading.
Link to answerDoes Softlight reuse files it has already downloaded?
Verified provider files can be reused from a local content cache, with a 5 GiB eviction limit. The launcher copies and rechecks cached files instead of linking editable installation files to a shared original.
Game assets, libraries, and Java runtimes also use shared local resources where appropriate. Separate installations still have their own worlds, mods, and configuration. Cached files do not bypass provider restrictions or integrity checks.
Link to answerWhat do Remove task and Clear all delete?
They remove finished entries from the Tasks history. They do not delete game files or cancel active downloads. Use the task's Cancel control to stop work that is still active.
The task list is session history and is not preserved across launcher restarts. To remove an actual installation, use its own deletion action and read the confirmation.
Link to answerHow do I update Softlight?
Open Settings > Launcher updates and choose Check for updates. When an update is available, Update now and the title-bar update button start the same workflow.
The installed app shows a download, verification, and restart screen. You choose when to start. Current published builds enable in-app updates; older previews that disabled updates need a newer installer from the website first. Update checks are not available in a plain browser view.
Link to answerWhy can't an update start while something is running?
Updating replaces the launcher. Games, servers, sharing sessions, active downloads, pending operations, and unresolved file edits can block the handoff.
Stop the relevant activity and save or discard file drafts, then start Update now again. While the update screen is active, conflicting actions and pack drops are blocked, and incoming invitations wait.
Link to answerWhat happens if an update fails or I close the app?
A failed download or integrity check reports an error instead of installing unverified bytes. Use Retry or download the current installer from the website if needed.
Cancel, Close, or Quit before installer handoff cancels the update. Once the verified installer has been handed off, it replaces and reopens the app. Keep independent backups of important worlds even though updating the launcher is separate from editing game data.
Link to answerServers
Which servers can I run locally?
Servers supports built-in installation of Vanilla, Paper, Purpur, Fabric, Forge, and NeoForge. You can also review a custom server JAR or supported server import.
Each managed server has its own directory, Java selection, console, content, settings, player controls, and backups. Local server management does not require a Softlight sharing account. A dedicated server process still uses your computer's CPU, memory, disk, and network.
Link to answerHow do I create and start a server?
Open Servers, create a server, and choose an engine and Minecraft version. Review its name, memory, and Java settings.
- Use the server's start action. Softlight prepares missing engine files and Java as needed.
- On first start, read Minecraft's EULA and explicitly accept it if you agree. Cancelling keeps the server stopped.
- Watch the Console until the engine reports that startup is complete.
- Use its displayed local address to connect, or create a private invitation when sharing is available.
Can I import an existing server?
Supported review paths include a custom JAR, a copied server folder, an author-supplied server ZIP, and a server-compatible .mrpack. Review the proposed engine and files before proceeding.
Imported scripts are not executed. An ordinary client modpack is not automatically converted into a dedicated server pack. Stop the original server and keep a separate backup before importing its world.
Link to answerWhat does the server dashboard show?
The dashboard summarizes the server and, while available, its player count, memory use, CPU use, and supported engine tick-rate readings.
A missing reading means the metric is unavailable, not necessarily zero. Engine support and whether the process is starting, running, or stopped affect what can be measured. Use Console for the actual startup or failure message.
Link to answerCan I send commands and follow server output?
Open the server's Console. Send commands while it is starting or running, and use Copy console to copy the visible source. Warning and error colors help scan output, but read the message and surrounding lines too.
Scrolling up pauses Follow latest output so new lines do not pull you away. Turn following back on to return to the end. Commands can change the world and player permissions, so check what a command does before sending it.
Link to answerHow do I install server mods or plugins?
Use the server's Content tab. Fabric, Forge, and NeoForge servers browse compatible mods from Modrinth and CurseForge. Paper and Purpur browse plugins from Hangar and Modrinth; SpigotMC is not a catalog source.
You can browse while a server runs, but installation, updates, imports, enable/disable, and removal require it to be stopped with no pending server downloads. Review dependencies and versions before applying changes. Client-only mods are not automatically suitable for a dedicated server.
Link to answerWhich server settings can I edit?
The Settings tab groups server.properties options into General, Gameplay, World, Players, Network, Performance, Resource pack, Advanced, and Additional. Search finds property names and descriptions. Available fields depend on the engine and Minecraft version.
You can configure supported properties, memory, Java, and the server name. Multiline MOTDs preserve entered spacing. Stop the server before saving changes. Minecraft authentication stays enabled, the managed address stays on loopback, and RCON/query stay disabled; protected settings are not editable overrides.
Link to answerHow do player lists and moderation work?
The Players tab provides the live roster when it is available, plus saved operator, whitelist, and ban information. Use its search and list controls to find a player.
Supported actions include managing operator and whitelist access and bans. Read the confirmation and any command error. A stopped server's saved lists are not proof that those players are currently online.
Link to answerHow do server backups and engine changes work?
Use the server's Backups tab while it is stopped. Backups cover the stopped server's files; restoring replaces the relevant current state, so keep the version you may need before proceeding.
Changing an engine backs up existing files first. A backup does not guarantee that a world or plugin will work on a different engine or an older Minecraft version. Keep an additional copy outside the server directory for important worlds.
Link to answerWhat happens when I close Softlight with a server running?
Closing the window can leave active servers running through the tray. Quit stops them gracefully. Stop a server normally before changing files, restoring backups, or updating the app.
Use Force stop only when ordinary shutdown will not finish; abruptly ending the process can interrupt writes. Keep Softlight open for shared sessions, because it manages the connection as well as the local server.
Link to answerIs a server picture the same as its Minecraft server icon?
No. The picture selected in Softlight changes the local launcher entry. Minecraft's multiplayer list uses server-icon.png in the server folder.
Softlight can supply its default Minecraft server icon when one is missing and preserves an existing custom icon. Changing your Library or server profile picture does not overwrite that file.
Link to answerPlaying together
How does direct world sharing work?
Share a running managed server, or open a singleplayer world to LAN and use Servers > Share world. When the connection service is available, Softlight creates a private invitation for your guest.
Send the invitation privately. Both players must keep Softlight open and use compatible Minecraft versions and mods. Sharing does not upload a permanent copy of your world or make an offline computer available. Connecting still depends on the service and both players' networks.
Link to answerDo I need an account for sharing?
No. There is no sharing registration or Microsoft sign-in step. Anyone with a valid private invitation can join without separate host approval, so only send it to people you trust. Playing Minecraft still requires its normal login and ownership checks.
Connect signaling and STUN/TURN support the connection without a separate Softlight account. The old account-based sharing protocol is retired; use a current invite-based launcher on both sides.
Link to answerHow do I share a singleplayer LAN world?
In Minecraft, choose Open to LAN first. Softlight can detect the port from recognized console messages when it launched that game. In Servers > Share world, select the detected world and choose Create invitation.
Use Enter port manually when the game came from another launcher or its logging format cannot be detected. Enter the port Minecraft reports. If several worlds are open, choose the intended one. Closing that world stops its sharing; a newly detected world is not shared until you ask.
Link to answerHow do I join a friend's invitation?
Open the full HTTPS invitation your host sent. The website's Open Softlight link hands it to the installed Windows app. If your browser refuses to open the app, copy the invitation and paste it into Servers > Join server.
- Keep the host's world or server running and its invitation active.
- Open or paste the invite in Softlight and wait for the connection.
- Choose a compatible installed profile and use Play & join, or copy the local address into Minecraft Direct Connect.
- Joined sessions can also be advertised locally for Minecraft's LAN list. If an entry is missing or stale, refresh Multiplayer or use the copied address.
When do invitations expire, and can I revoke one?
An invitation expires after one hour. Expiry prevents new joins with that link but does not disconnect peers already connected.
Regenerate the invitation to invalidate the previous link. Disconnecting a guest alone leaves the invitation usable, so regenerate it too if you no longer want that link to admit them. Stopping sharing ends the hosted session.
Link to answerWhat do Direct and Relay mean?
Direct means the peers established the preferred direct connection. Relay means traffic uses an authenticated relay when that fallback is configured and available.
Softlight does not make router changes for you. A network that blocks direct traffic may still fail when relay service is unavailable. Peers can learn each other's IP addresses; invitation sharing is not an anonymity service.
Link to answerDoes an invitation install the host's mods for me?
No. An invitation connects you to the host; it does not automatically replace your profile or synchronize a modpack.
Match the Minecraft version, loader, and required client mods before joining. Profile suggestions are recommendations, not proof of a complete match. Use the same pack version when the server requires it, and read the host's instructions for client-only or server-only differences.
Link to answerFiles & logs
What can the built-in file manager do?
Library installations have a Files tab, and servers expose file tools through Content. Browse folders and breadcrumbs, import files, create text files or folders, rename items, and confirm deletions.
Explorer file drops copy into the current folder without silently overwriting an existing name. Folder drops are not supported. Stop games or servers before mutations when the app requires it. Protected launcher metadata and unsafe linked paths are not ordinary editable files.
Link to answerWhich files can I edit inside Softlight?
The editor handles supported UTF-8 text, including UTF-8 BOM, up to 1 MiB. It provides line numbers, search, undo/redo, keyboard saving, and highlighting for formats such as JSON, YAML, TOML, and properties.
Binary, oversized, or non-UTF-8 files remain visible but are not editable there. The editor preserves line endings. Server property edits still respect the managed server's protected settings.
Link to answerWhy is the editor warning about unsaved changes or a conflict?
Softlight asks you to save or discard drafts before navigation or replacement that could lose an edit. A conflict means the underlying file changed since you read it.
Keep a copy of your intended changes and reread the current file before combining them. The app preserves the draft instead of silently overwriting external changes. Stopping the game or server first can prevent it from rewriting the same configuration while you edit.
Link to answerWhere can I view my Minecraft screenshots?
Open an installation's Screenshots tab. It reads PNG files from that installation's screenshots folder and offers thumbnails and a full-size view.
If the gallery is empty, confirm which installation produced the screenshot and whether the file is in its screenshots folder. Images remain local; viewing them in Softlight does not upload them.
Link to answerWhat's the difference between Latest log and Console?
Latest log reads the installation's logs/latest.log file and refreshes while visible. Console shows output captured for the current launcher session. They can differ, especially after a restart or when no new game session has written a log.
Use the source that contains the failure you are investigating. Follow latest output can be paused by scrolling up. The copy and upload actions work with the selected source.
Link to answerHow can I share a log safely?
Choose Upload log from the installation or server console. Opening the review does not upload anything. Inspect the exact preview, then choose Upload to mclo.gs if you want a shareable link.
Softlight redacts recognized secrets, IP addresses, and local paths, but player names and chat can remain. Anyone with the link can read the uploaded log. The preview includes at most the latest 5,000 lines and 1 MiB, and labels truncated content. Review it yourself before publishing.
Link to answerCan I delete a log I uploaded?
The upload result offers Delete upload when deletion access is available, with a separate confirmation. It deletes the public upload, not your local log.
Deletion access is kept in app memory and is not saved across quitting. The third-party upload can remain until it is deleted or expires. If you need to remove it through Softlight, do so before closing the app.
Link to answerHow should I back up worlds and launcher data?
Stop games, dedicated servers, and downloads before making a file backup. Use Open folder to locate a particular installation, or read the Data directory shown in Settings > Local data. The normal launcher data location is %APPDATA%\Softlight.
- Copy important saves, mods, configuration, and other needed files to a separate location.
- Use the stopped-server backup tools for a managed server and keep an additional independent copy of important worlds.
- Keep the original backup while testing a restore or a new Minecraft/modpack version.
- Treat account credential files separately. Windows-backed encrypted credentials are not a portable way to sign in on another computer.
Skins & appearance
How do I save or edit a skin?
Open Skins and choose a PNG or drag one into the upload control. Give the saved skin a name and choose its Classic or Slim model. The local library supports editing these details, exporting a PNG, and deleting a saved entry.
Edit skin changes the name, model, or source image. It is not a pixel-paint editor. Saving a skin locally does not change the active Minecraft account's skin.
Link to answerWhich skin files and preview controls are supported?
Skin images must be valid PNG files within the 1 MB limit. Modern 64x64 textures are supported; legacy 64x32 textures use the Classic model.
The 3D preview can be dragged or rotated with its keyboard controls. Pause stops its idle animation, and reduced-motion preferences are respected. A graphics fallback is shown if the preview cannot render.
Link to answerWhy does Apply skin need sign-in?
Apply skin changes the selected Minecraft account through Minecraft's service, which requires a valid authenticated profile. Check the active account before applying.
Saving, naming, previewing, and exporting a local skin are separate actions. Live account skin changes depend on successful Minecraft authentication and provider access; a working preview does not confirm that upload access is available.
Link to answerCan I change the app's theme or accent?
Settings > Appearance offers Dark, Light, and System modes, accent presets, and a custom six-digit hex/color picker. System follows Windows. Appearance changes save immediately, and Reset appearance restores the current app defaults.
The website follows your device's light or dark appearance and shows the matching launcher screenshot. Changing the launcher's appearance does not change the website, your game resource packs, or the Minecraft account skin.
Link to answerPrivacy & support
Why might the website say a download is unavailable?
The website checks the release information and whether its installer is actually available before enabling the download. Release notes can still be readable when the installer is missing or release storage cannot be reached.
Use Try again after a temporary failure. Do not guess a filename or substitute an unofficial installer. The Download page's version, size when published, and checksum describe the linked release.
Link to answerWhere do the website's release notes come from?
The Updates page reads the current launcher's live release feed and published history, with the newest updates first. The website does not bundle old release notes or use the retired Electron history.
The download page checks the current hosted packages before enabling downloads. Published release notes can remain after an older package has been removed; a note does not promise that its installer is still hosted.
Link to answerWhat does the website do with a private invitation?
The /join page reads the secret from the link fragment, removes it from browser history, and offers Open Softlight and Copy invite. Browsers do not send that fragment as part of the normal HTTP request.
The page uses no account login or browser storage for the invite. Reloading after the secret has been cleared can show Invitation unavailable; open the original message's full link again. Treat the original invitation as private access, and do not include it in screenshots or public bug reports.
Link to answerDoes Softlight collect analytics or upload my files?
Softlight has no advertising. Usage analytics and sanitized diagnostics are enabled on public website pages. In the desktop app, Privacy & diagnostics settings control analytics and masked replay for sessions with errors. Private invitation pages are excluded from website collection.
Installations, screenshots, settings, and saved skins normally stay on your computer. Applying an account skin sends that skin to Minecraft; explicitly uploading a reviewed log sends that snapshot to mclo.gs. Those actions have different recipients and are not background analytics.
Link to answerWhere are settings and credentials stored?
Settings > Local data shows the launcher's actual data directory; the default is %APPDATA%\Softlight. Installations, server files, settings, groups, and saved skins are stored locally.
Saved Microsoft authentication credentials use Windows-backed encryption separately from game installations. Invitation secrets and relay credentials are held in memory by the current sharing system. Current packaged releases use bundled CurseForge access rather than a user-entered key. Do not share your entire data directory as a troubleshooting attachment.
Link to answerHow do I use this guide or share an answer?
Choose a topic from the sidebar, or open Topics on a small screen. Search checks questions, answers, and steps across every topic. Press / to jump to search, and Escape to clear it.
Open an answer and select Link to answer to put its permanent address in the browser bar. Copy that address to share it. Existing answer links still open the right question.
Link to answerWhat should I include when reporting a problem?
Describe what you were trying to do, the steps that reproduce the issue, and what happened instead. Contact the operator at the address below; account ownership and billing problems may need Minecraft's own support.
- Softlight version and operating system.
- Minecraft version, loader or server engine, and pack/project version if relevant.
- The exact safe error message and whether the problem affects one installation or several.
- A screenshot or reviewed log link when useful. Remove player chat or other private material you do not want to share.
- For connection issues, whether you were hosting or joining and whether Direct or Relay was reported. Never send an invite secret, password, token, API key, or credential file.