Platform Documentation

PortalMine Documentation: Dashboard and Server Setup

A practical guide to PortalMine server creation, dashboard controls, Hardcore Mode, settings, logs, files, plugins, and support.

Maintained by PortalMine Operations & DocumentationReviewed 2026-07-13

PortalMine dashboard map

The dashboard separates routine owner tasks so you can identify whether you are changing server state, server configuration, files, software extensions, or account details. A control can be unavailable while the server is installing, starting, stopping, or offline.

AreaUse it forBefore you change anything
ServerStatus, address, start, stop, restart, timer and extensionsRead the current state and save console evidence before restarting
ConsoleStartup output, warnings, commands and crash contextCopy the first meaningful error and its timestamp
FilesConfiguration, logs, worlds and uploaded filesDownload a backup and avoid editing while the server writes
SettingsName, difficulty, mode, whitelist, online mode, PvP and HardcoreUnderstand whether the setting needs a restart
Plugins / add-onsSearch, install and remove supported extensionsMatch software and Minecraft version
ProfileUsername, server address and password optionsChanging the username can change the PortalMine address

Create a server safely

  1. Choose Java or Bedrock based on the players’ actual editions.
  2. Select the offered server software and version.
  3. Leave Hardcore Mode off unless permanent-death-style gameplay is intentional.
  4. Review the level’s memory, player, and runtime limits.
  5. Create the server and wait for installation to complete before sending repeated power actions.
  6. Read the first successful console startup and save the connection address.

Hardcore Mode

PortalMine exposes Hardcore Mode during server creation and in Server Settings. It is off by default. When enabled for supported software, the server uses survival-oriented hardcore behavior and hard difficulty. Back up the world before changing this on an established community and verify the result after restart.

Power actions and coins

Start, restart, extend, and level actions can have different coin costs. Read the confirmation text before continuing. A restart is not a substitute for diagnosis: save console errors first, because the most useful crash lines may be lost in the next startup output.

Recommended first-session test

  • Join with one owner account.
  • Confirm the displayed edition, version, address, and port.
  • Break and place blocks, change dimensions, and reconnect.
  • Test whitelist and operator access with a second non-admin account.
  • Create the first backup before installing plugins, mods, or add-ons.

Support checklist

When contacting PortalMine, include the server type, version, status, approximate time, first error line, and action you attempted. Never send your password, API token, full session cookie, or private player information.

Server Settings reference

Change settings deliberately. Name changes affect display labels; game mode and difficulty change gameplay; whitelist controls access; online mode controls Java identity verification; PvP changes player combat; and Hardcore Mode changes the risk profile of the world. Some changes require a restart before the server process reloads server.properties.

Hardcore Mode safety checklist

  1. Explain the rules to every player.
  2. Create a timestamped backup.
  3. Confirm Survival and Hard difficulty expectations.
  4. Restart the server after saving.
  5. Test with a non-owner player.
  6. Record how deaths, bans, and world resets will be handled.

Files and logs

Use the Files area for controlled edits, not live experimentation. Download the file before changing it, preserve line endings and encoding, and avoid editing world data while the server is actively writing. In logs, start from the first exception or warning tied to the failure rather than only the final shutdown line.

Plugin and add-on checks

Confirm that the extension matches Java Paper/Purpur or Bedrock Nukkit as appropriate. Install one change at a time, restart when required, and verify the feature with an ordinary player account. Remove an extension only after backing up its data and reading its migration notes.

Custom Server workflow

  1. Select a complete server package and allow automatic type detection where appropriate.
  2. Wait for the upload and server-side preparation stages to finish.
  3. Confirm the startup entry file and runtime in the console.
  4. Use the Java plugin area only when the detected software supports Java plugins.

Detailed custom server guide

File Manager workflow

Use Files for uploads, folders, editing, extraction, rename, cut, copy, paste, move, download, and deletion. Stop the server before replacing worlds or editing files written continuously by the process. Large uploads can continue through multiple server-side stages after the browser reaches 100%.

Share selected servers

Profile sharing should expose only the servers selected for that link and only the permissions granted. Revoke old links after ownership changes or when a collaborator no longer needs access. Never share the owner account password.

Understanding server states

StateMeaningCorrect owner action
Installing / provisioningFiles and initial configuration are being preparedWait; do not send repeated start or restart requests
StartingThe game process is loading software, world and extensionsWatch the console until ready or until a clear error appears
RunningThe process is active and should be listening for playersTest connection and review warnings before inviting players
StoppingThe server is saving and closingAllow completion to reduce world-write risk
OfflineNo active game process is availableStart only after confirming installation and configuration are valid
Failed / unavailableA workflow or dependency did not completeSave evidence, check status, then follow the relevant guide

Console-first troubleshooting workflow

  1. Record the time and the visible dashboard state.
  2. Copy the first meaningful warning or error, including several surrounding lines.
  3. Identify the component named in the message: software, plugin, mod, configuration, world, network, storage, or authentication.
  4. Compare the error with the last change and the last successful startup.
  5. Use the Error Library before applying unrelated fixes.
  6. After correction, restart once, confirm ready state, and test a representative connection.

Safe file-management rules

  • Stop the server before replacing worlds, databases, or actively written configuration files.
  • Download a backup before deleting, renaming, converting, or uploading important data.
  • Preserve folder structure and filename case.
  • Do not upload executable or unknown files from untrusted sources.
  • Keep the original copy until the replacement passes startup, connection, saving, and restart tests.

Preparing a useful support bundle

Include the PortalMine username or server reference permitted by the support form, server edition and software, Minecraft version, exact time with timezone, current status, connection address format, first relevant console error, last change, reproduction steps, and what has already been tested. Redact passwords, tokens, cookies, private IP information that is not necessary, and personal player data.

Change-management template

FieldExample content
PurposeUpdate Paper and two required plugins for a security fix
BackupFull world and configuration backup verified before maintenance
RiskPlugin API incompatibility or startup failure
TestClean startup, join, permissions, commands, world save and restart
RollbackRestore previous software, plugins and pre-change backup