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 settings
  • teleport-config.json - Teleportation behavior and cooldowns
  • portal-config.json - Portal system configuration
  • auto-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, spectator
  • defaultWorldType - void, flat, normal, skyblock
  • maxDimensions - 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.