⚠️ The latest release is unstable — use preview builds instead
Skip to content

Server Settings

Game and server settings are configured via server-settings.json. This file is auto-created with sensible defaults inside the Docker settings volume on first startup.

Accessing the Settings File

To view current settings:

sh
docker compose exec server cat /data/settings/server-settings.json

To edit:

sh
# Copy out
docker compose cp server:/data/settings/server-settings.json ./server-settings.json

# Edit the file with your preferred editor

# Copy back
docker compose cp ./server-settings.json server:/data/settings/server-settings.json

# Restart to apply
docker compose restart

Default Settings

json
{
  "Game": {
    "FarmName": "Junimo",
    "FarmType": 0,
    "ProfitMargin": 1.0,
    "StartingCabins": 1,
    "SpawnMonstersAtNight": "auto"
  },
  "Server": {
    "MaxPlayers": 10,
    "CabinStrategy": "CabinStack",
    "SeparateWallets": false,
    "ExistingCabinBehavior": "KeepExisting",
    "VerboseLogging": false,
    "AllowIpConnections": false,
    "LobbyMode": "Shared",
    "ActiveLobbyLayout": "default",
    "AdminSteamIds": []
  }
}

Game Creation Settings

These settings only take effect when creating a new game. They are ignored when loading an existing save.

SettingDescriptionDefault
FarmNameFarm name displayed in-game"Junimo"
FarmTypeFarm map type (see table below)0
ProfitMarginSell price multiplier1.0
StartingCabinsNumber of cabins created with new game1
SpawnMonstersAtNightMonster spawning: "true", "false", or "auto""auto"

Farm Types

ValueFarm Type
0Standard
1Riverland
2Forest
3Hilltop
4Wilderness
5Four Corners
6Beach
7Meadowlands

Profit Margin

ValueDifficulty
1.0Normal prices
0.7575% prices (harder)
0.550% prices (hard)
0.2525% prices (very hard)

Monster Spawning

  • "true" — Monsters spawn at night on all farm types
  • "false" — No monster spawning
  • "auto" — Only spawn on Wilderness farm type

Server Runtime Settings

These settings apply on every startup and can be changed between runs.

SettingDescriptionDefault
MaxPlayersMaximum concurrent players10
CabinStrategyCabin management strategy"CabinStack"
SeparateWalletsEach player has their own moneyfalse
ExistingCabinBehaviorHow to handle visible cabins"KeepExisting"
VerboseLoggingEnable detailed debug loggingfalse
AllowIpConnectionsAllow direct IP connectionsfalse
LobbyModeLobby mode for password protection"Shared"
ActiveLobbyLayoutActive lobby layout name"default"
AdminSteamIdsSteam IDs auto-granted admin on join[]

Cabin Strategies

StrategyDescriptionBest For
CabinStackCabins hidden off-map. Each player sees only their own at a shared position.Most servers
FarmhouseStackCabins hidden off-map. All players warp to shared farmhouse interior.Co-op focused
NoneVanilla behavior. Cabins placed at real farm positions.Traditional multiplayer

Existing Cabin Behavior

Controls what happens to visible cabins already on the farm when using a stacked strategy.

BehaviorDescription
KeepExistingLeave existing cabins at their positions. Only new cabins follow the strategy.
MoveToStackRelocate all visible cabins to the hidden stack on startup.

Wallet Modes

SettingDescription
falseShared wallet — all players share one money pool
trueSeparate wallets — each player has their own money

You can toggle this in-game using the !changewallet admin command.

Direct IP Connections

WARNING

Direct IP connections don't provide user IDs, so the server can't track farmhand ownership. Players may lose access to their farmhands if they reconnect from a different IP.

Only enable if you need it for specific network configurations.

Password Protection Settings

For lobby mode and layout settings, see Password Protection.

SettingDescription
LobbyMode"Shared" (all in one lobby) or "Individual" (separate lobbies)
ActiveLobbyLayoutName of the lobby layout for new players

Released under the MIT License.