SimpleMobSwitch Mod - ChangeLog

[1.0.0] - 2025-5-30

🎉 Initial Release

✨ New Features

• Dynamic Mob Cap Control System

  • Automatically spawns dummy mobs (Shulkers) based on player count
  • Basic formula: Player count × 70 = Required dummy mobs
  • Real-time mob count adjustment

• Command System

  • /mobswitch on - Enable mob switch
  • /mobswitch off - Disable mob switch
  • Requires OP permission (level 2+)

• Persistence System

  • State restoration after server restart
  • World data saved in NBTCompound format
  • Dummy mob UUID management

• Spawn Chunk Method

  • Utilizes always-loaded spawn chunks
  • Stable chunk loading
  • Independent from nether portal methods

🔧 Technical Specifications

• Supported Version: Minecraft 1.20.x + Fabric
• Placement: 3 chunks away from spawn chunk (Y=1000)
• Entity Type: Shulker (EntityType.SHULKER)

⚡ Performance Optimization

• AI Processing Optimization

  • Dummy mob AI disabled (setAiDisabled(true))
  • Physics disabled (setNoGravity(true))
  • Sound processing disabled (setSilent(true))

• Visual Optimization

  • Dummy mobs invisible (setInvisible(true))
  • Custom name hidden (setCustomNameVisible(false))
  • Invulnerable to prevent accidental removal (setInvulnerable(true))

• Memory Efficiency

  • Lightweight UUID-based state management
  • Minimal data storage

🛡️ Safety Features

• Error Handling

  • Proper handling of spawn failures
  • State consistency checking
  • Detailed logging (INFO, ERROR levels)

• Server Lifecycle Management

  • Automatic state restoration on startup
  • Proper cleanup on shutdown
  • Dynamic adjustment on player join/leave

📋 Limitations

• Dimension Limitation: Overworld only
• Permission Requirement: Requires OP permission (level 2+)
• Impact Scope: Affects server-wide mob spawning

🔍 Implementation Details

• Mixin Usage: Minimal intervention to MinecraftServer class
• Non-invasive Design: Minimal impact on existing game systems
• Fabric API: Standard Fabric mod development practices

---

📖 Usage

1. Place the mod in the server's mods folder
2. Start the server
3. Execute /mobswitch on command with OP permission
4. Mob spawning will be automatically controlled based on player count

🎯 Target Users

• Server administrators
• Mob farm operators
• Performance-focused server operators
• Players who want to control mob spawning for building projects

🔗 References

• Minecraft Wiki - Mob Switch
• Minecraft Wiki - Spawn Chunks

---

Warning: This mod affects server-wide mob spawning. Always create backups and test in a development environment before use.