Menu
 

Server Configuration Guide - Necesse Wiki

Server Configuration Guide

Necesse offers extensive server configuration options allowing you to customize your gaming experience. This comprehensive guide covers all available settings, their effects, and how to configure them through the Supercraft panel or directly in configuration files.

Configuration Overview

Necesse uses CFG configuration files for server configuration. Settings can be adjusted through the Supercraft configuration panel or by editing files directly.

Server Settings (server.cfg)

Setting Type Default Description
password strProp` Empty `password`
Valid values: Join password
motd String Empty `motd`
Valid values: Message of the day
pause Boolean `true` `pause`
Valid values: Pause when empty

World Settings (worldSettings.cfg)

Setting Type Default Description
difficulty Select `CASUAL`, `NORMAL`, `HARD` `difficulty`
Valid values: World difficulty
deathPenalty Select `NONE`, `DROP_MATS`, `DROP_ALL` `deathPenalty`
Valid values: Death drop mode
allowCheats Boolean Boolean `allowCheats`
Valid values: Enable cheats
forcedPvP Boolean Boolean `forcedPvP`
Valid values: Force PvP mode
playerHunger Boolean Boolean `playerHunger`
Valid values: Enable hunger
disableMobSpawns Boolean Boolean `disableMobSpawns`
Valid values: Disable spawns

Settlement Settings

Setting Type Default Description
maxSettlementsPerPlayer Integer -1 to 100 `maxSettlementsPerPlayer`
Valid values: Settlement limit (-1=unlimited)
unloadSettlements Boolean Boolean `unloadSettlements`
Valid values: Unload empty settlements

Raid Settings

Setting Type Default Description
raidFrequency Select `NEVER`, `RARELY`, `OCCASIONALLY`, `OFTEN` `raidFrequency`
Valid values: Raid occurrence

Time Settings

Setting Type Default Description
dayTimeMod Float 0.1-10.0 `dayTimeMod`
Valid values: Day length multiplier
nightTimeMod Float 0.1-10.0 `nightTimeMod`
Valid values: Night length multiplier

Client Permissions

Setting Type Default Description
giveClientsPower Boolean `false` `giveClientsPower`
Valid values: Allow client commands

Frequently Asked Questions

How do I change the difficulty in Necesse?

To change difficulty in Necesse, navigate to the Configuration panel in Supercraft and locate the 'Difficulty' or 'Preset' setting under Gameplay Settings. Select your preferred difficulty level and save your configuration. Restart your server for changes to take effect.

How do I enable PvP in Necesse?

Enable PvP by setting the PvP or player damage option to 'Enabled' in the Gameplay Settings section. Some games also allow you to configure friendly fire separately. Save your configuration and restart the server.

How do I set a password for my Necesse server?

Set a server password in the Basic Server Settings section. Enter your desired password in the 'Server Password' field. Leave it empty for a public server without password protection. Save and restart your server.

Why aren't my configuration changes applying?

Configuration changes require a server restart to take effect. After saving your settings in the Supercraft panel, restart your server. If changes still don't apply, verify the configuration file syntax is correct and check server logs for errors.

Can I upload a custom configuration file?

Yes, you can upload custom configuration files through the Supercraft file manager. Navigate to the configuration directory, upload your file, and restart the server. Ensure your file follows the correct format for your game.

Do I need to restart the server after changing settings?

Yes, most configuration changes require a server restart to take effect. Some games support hot-reloading for specific settings, but it's recommended to always restart after making configuration changes.

Using the Supercraft Configuration Panel

Our platform provides a user-friendly interface for managing your Necesse server configuration without editing files manually.

  1. Log in to your Supercraft panel at https://supercraft.host/my-account
  2. Navigate to your Necesse server from the deployments list
  3. Click the "Configuration" tab
  4. Adjust settings using the intuitive form controls
  5. Click "Save Configuration" to apply changes
  6. Restart your server for changes to take effect

The configuration panel validates your inputs and prevents invalid values, ensuring your server starts correctly.

Troubleshooting

Settings not applying after save

Ensure you've restarted the server after saving configuration changes. Most settings require a full server restart. Check the server logs for any configuration errors that might prevent the server from starting.

Configuration file validation errors

Verify that your configuration file follows the correct format for your game. Check for syntax errors like missing quotes, incorrect separators, or invalid values. Use the Supercraft configuration panel to validate settings before applying them.

Server won't start after config change

Revert to the previous working configuration using the Supercraft file manager's backup feature. Check server logs for specific error messages. Common issues include invalid port numbers, malformed file paths, or out-of-range numeric values.

References

Top