Files and Mods

Some game servers expose file management, plugin, or mod tools in the Portal.

Before changing files

Create a backup before adding, removing, or replacing:

• Worlds or save data
• Configuration files
• Mods
• Plugins
• Runtime files

Make sure files match the game, runtime, and version your server uses. Incompatible mods or plugins can prevent the server from starting.

Uploading or editing files

Use the Portal file tools when they are available. Save changes, then restart the server if the game requires a restart before changes take effect.

Avoid uploading sensitive credentials into server files.

Installing mods

Only install mods from sources you trust. Check the mod version and dependencies before installing. If a mod requires a specific loader, use the matching runtime.

Worked example: add one mod

For a Minecraft Fabric server:

1. Create a backup.
2. Confirm the server is using Fabric and the same Minecraft version as the mod.
3. Download the mod file from a source you trust.
4. Open Files in the Portal.
5. Upload the mod file to the mods folder.
6. Restart the server.
7. Watch the console until the server finishes starting.

If the mod requires another dependency mod, upload that dependency before restarting.

If a mod breaks startup

The usual symptom is a server that changes to starting, then stops or returns an error in the console.

1. Open the console and read the newest error.
2. Remove the last mod or plugin you added.
3. Restart once.
4. If the server starts, check the mod version, loader, and dependencies before trying again.

For a deeper checklist, see Server Won’t Start After a Change.

After changes

Restart the server and watch the console. If the server fails to start, note the most recent errors and either remove the recent change or restore from a known-good backup.