Configuration - MarkusBordihn/BOs-World-Dimension-Nexus GitHub Wiki
🔧 Configuration
World Dimension Nexus can be customized through configuration files and in-game settings to match your server's specific needs.
📁 Configuration Files
The mod creates configuration files in the config/worlddimensionnexus/
directory:
dimension-config.json
- Dimension creation and management settingsteleport-config.json
- Teleportation behavior and cooldownsportal-config.json
- Portal system configurationauto-teleport-config.json
- Auto-teleport system settings
⚙️ Key Configuration Options
Dimension Settings
{
"defaultGameMode": "survival",
"defaultWorldType": "void",
"maxDimensions": 50,
"enableAutoSave": true,
"autoSaveInterval": 300
}
Options:
defaultGameMode
- survival, creative, adventure, spectatordefaultWorldType
- void, flat, normal, skyblockmaxDimensions
- Maximum custom dimensions (1-100)autoSaveInterval
- Save frequency in seconds (60-3600)
Teleportation Settings
{
"playerCooldown": 5,
"moderatorCooldown": 2,
"adminCooldown": 0,
"enableSafetyChecks": true,
"maxSearchRadius": 16,
"preventSuffocation": true
}
Key Features:
- Cooldowns - Different delays by permission level
- Safety Checks - Prevent void/suffocation teleports
- Search Radius - Distance to find safe landing spots
Auto-Teleport Settings
{
"enableJoinTeleport": true,
"enableDeathTeleport": true,
"delayJoinTeleport": 1,
"showTeleportMessages": true
}
Portal Settings
{
"enablePortals": true,
"portalActivationDelay": 2,
"portalCooldown": 5,
"maxPortalDistance": 1000
}
🔐 Permission Levels
- Level 0-1: Regular players (no mod commands)
- Level 2: Moderators (teleport, view info)
- Level 3: Gamemasters (create/modify dimensions)
- Level 4: Administrators (all features)
🎯 Common Server Configurations
High-Traffic Server
{
"playerCooldown": 10,
"maxConcurrentTeleports": 5,
"unloadEmptyDimensions": true
}
Creative Building Server
{
"defaultGameMode": "creative",
"defaultWorldType": "void",
"playerCooldown": 2,
"enableSafetyChecks": false
}
Minigame Server
{
"defaultGameMode": "adventure",
"defaultWorldType": "flat",
"playerCooldown": 1,
"delayJoinTeleport": 0
}
🔄 Applying Changes
Most configuration changes require a server restart:
# Reload some settings (if supported)
/wdn debug reload config
# Full restart (recommended)
/stop
The mod validates configuration on startup and replaces invalid values with defaults.
🛠️ Advanced Features
- Custom World Types - Integration with datapacks
- Mod Integration - Compatibility settings for other mods
- Performance Tuning - Memory and cache optimization
For detailed configuration examples and troubleshooting, see the Troubleshooting guide.