Описание
# 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 `.
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 `
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 `/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](https://github.com/SuperMartijn642)
## Community