Fakeplayer Chunkloader

Fakeplayer Chunkloader

A Minecraft mod that keeps chunks loaded with fake players while providing live HUDs and map controls for monitoring without relying on real players.

Supported versions

| Minecraft | Loaders | |-----------|---------| | 1.21 / 1.21.1 | Fabric, Forge, NeoForge | | 1.21.2 / 1.21.3 | Fabric, Forge, NeoForge | | 1.21.4 | Fabric, Forge, NeoForge | | 1.21.5 | Fabric, Forge, NeoForge | | 1.21.6 / 1.21.7 / 1.21.8 | Fabric, Forge, NeoForge | | 1.21.9 / 1.21.10 | Fabric, Forge, NeoForge | | 1.21.11 | Fabric, Forge, NeoForge | | 26.1 / 26.1.1 / 26.1.2 | Fabric, Forge, NeoForge | | 26.2 | Fabric, Forge, NeoForge | | 26.3 | Fabric |

Highlights

• Dual mode: Fakeplayer (mob spawning + simulation distance) or Chunkplayer (chunk tickets only)
• Mob Target: Optional Fakeplayer-only toggle so mobs may aggro/pathfind (AFK farm target). Default off; no inventory, armor, or combat
• Visual markers & HUDs: Color-coded markers, live Simulation/Chunkplayer HUDs, and interactive chunk map
• Interactive map: Terrain-rendered chunk map with controls for toggling, radius adjustments, and mode switch
• Panel color & skins: Live UI color editor and custom skin PNGs for fakeplayers (per world / server-authoritative)
• Resilient config: Per-world JSON file with backups, limits, and auto-restoration

How to Use

Note: Commands require OP rights. OPs can grant permissions to other players using /fakeplayer permission grant <player>.

1. Add a player: Type /fakeplayer add (or /fp add) in chat at the location where you want to keep chunks loaded
2. Open menu: Right-click on the player to open the interactive menu
3. Disable a player: Attack the player (left-click) to disable it. It will be moved to the disabled players list (accessible via F8)
4. Remove a player: Sneak and attack (or sneak and right-click) the player to permanently remove it, or use /fakeplayer remove <name>
5. All information: Click the Info button in the menu to access all mod information, features, and details
6. Commands: Under the Info button, you'll find a Commands button with a complete list of all available commands

Key Controls

| Key | Function | |-----|----------| | F6 | Toggle Simulation Status HUD | | F7 | Toggle Chunkplayer Status HUD | | F8 | Open Disabled Players List |

All keybindings are configurable under Minecraft's Controls > Miscellaneous section or under Keybinds in the Menu.

Configuration

The mod automatically creates and manages configuration in <world-directory>/chunkloader/. Main file: chunkloader_config.json. All settings can be changed via commands or the interactive map.

Automatic features:

• Configuration is created automatically when you add your first player
• Up to two timestamped backups are kept in chunkloader/backups/ (plus a latest alias)
• Corrupted configs are automatically restored from backups
• One config per world; each player entry is keyed by dimension + chunk coordinates

Important Notes

• Fakeplayers never break blocks or use items
• Name lookups are case-insensitive and suggest alternatives if a name isn't found
• The system prevents overlapping players and warns when positions conflict
• Works across Overworld, Nether, and End
• Default UI radius is 0 (1 chunk center). Fakeplayer mode with mob spawning still uses a larger effective spawn/ticket radius (default system minimum ~8 simulation / ~10 loading rings) so vanilla-like mob spawning works, expect much higher chunk load than Chunkplayer mode at the same UI radius
• Chunkplayer mode respects the selected UI radius more closely (tickets only)
• Map/network actions require ownership of the player or admin permission (chunkloader.admin); destructive commands like reload/removeall also require admin
• Custom skins are server/world-authoritative (stored under chunkloader/skins/); the client clears local skin cache on join/disconnect so skins do not leak across worlds or Minecraft versions
• Mob Target is Fakeplayer-only. enabling it does not add inventory, armor, or combat, only aggro/pathfinding for AFK farms
• Open chunk maps refresh other player markers and occupied overlays live on create/delete/radius/disable; terrain tiles are not live
• Replacing the mod JAR keeps world data (players, names, skins, disabled list); only the code changes
• Players can only be disabled/removed by real players, not by mobs

Credits

• Chunk map design inspired by SuperMartijn642

Community