Commit d4b9a2
2025-05-11 18:05:06 Ry: initial commit| /dev/null .. anti-lag systems.md | |
| @@ 0,0 1,142 @@ | |
| + | # 🧹 Mine-play Anti-Lag System: Player Guide |
| + | |
| + | To keep our server running smoothly and lag-free for everyone, we use an automated anti-lag system. This guide explains what players should know about entity limits, redstone machines, farms, and more. |
| + | |
| + | --- |
| + | |
| + | ## ⚠️ Why We Have Anti-Lag Rules |
| + | |
| + | Too many mobs, hoppers, or redstone contraptions in one area can slow the server down for everyone. The anti-lag system helps manage this by automatically controlling or removing excess entities and machinery. |
| + | |
| + | --- |
| + | |
| + | ## 🐄 Entity Limits |
| + | |
| + | ### 📌 Per-Player Limits |
| + | |
| + | * **Wolves following players:** Max **3** per player (currently disabled). |
| + | * **Tamed mobs with names, items, or saddles** will **not be removed**. |
| + | |
| + | ### 📌 Chunk-Based Entity Limits |
| + | |
| + | Entities are limited **per chunk** or **grouped chunks** (e.g., a 3x3 chunk area). |
| + | |
| + | **If the limit is exceeded, extra entities may be removed automatically!** |
| + | |
| + | | Entity Group | Limit per Area | Notes | |
| + | | ----------------------------------- | -------------- | ------------------------------------------ | |
| + | | Animals (pigs, cows, sheep, etc.) | 40 | Applies to grouped area | |
| + | | Monsters (zombies, skeletons, etc.) | 40 | Includes hostile mobs | |
| + | | Example: Chickens | 20 | Even if animals aren't hostile, they count | |
| + | | Example: Sheep | 50 | Higher limit allowed | |
| + | |
| + | --- |
| + | |
| + | ## 🔁 Redstone and Hoppers |
| + | |
| + | ### Hoppers |
| + | |
| + | * Hopper transfer rates are **dynamically slowed** if overused. |
| + | * If you use many hoppers in a small area, they’ll **work slower** to reduce lag. |
| + | * This **breaks redstone contraptions** that rely on specific timing. |
| + | |
| + | | Setting | Value | Meaning | |
| + | | -------------- | -------------------------- | -------------------------------- | |
| + | | Default Rate | 8 ticks | Normal speed | |
| + | | Max Slow Rate | 40 ticks | Slowed to 1 item every 2 seconds | |
| + | | Adjust Trigger | Every 30 items transferred | | |
| + | |
| + | 💡 **Tip:** Keep hopper setups small and efficient! |
| + | |
| + | --- |
| + | |
| + | ## 🌱 Auto Clean System |
| + | |
| + | Every **30 seconds**, the server checks areas near players for excessive mobs. |
| + | |
| + | * **No warning** is given before cleanup. |
| + | * Players with `mfm.cleaninform` permission will be notified of cleanup results. |
| + | |
| + | --- |
| + | |
| + | ## 🚫 Block & Item Limits |
| + | |
| + | To stop lag machines, we limit certain block types **per chunk**. |
| + | |
| + | | Block Type | Max Per Chunk | |
| + | | -------------- | ------------- | |
| + | | Hoppers | 10 | |
| + | | Pistons | 10 | |
| + | | Sticky Pistons | 10 | |
| + | | Observers | 10 | |
| + | |
| + | 🛑 **Note:** Piston activity across chunks is monitored even more strictly. |
| + | |
| + | --- |
| + | |
| + | ## 🚷 Prevented Mob Spawns |
| + | |
| + | To reduce lag and potential abuse, some mob spawning is restricted: |
| + | |
| + | | Rule | Description | |
| + | | ------------------------------- | ------------------------------------------- | |
| + | | Over-limit mobs | **Will be removed** without warning | |
| + | | Natural Mob Spawn Reasons | Controlled (see technical section below) | |
| + | |
| + | --- |
| + | |
| + | ## 💾 Protected Entities |
| + | |
| + | To avoid accidental removal of important things, the following are **safe** during cleanups: |
| + | |
| + | ✅ Armor stands with items |
| + | ✅ Item frames with items |
| + | ✅ Tamed animals |
| + | ✅ Named animals |
| + | ✅ Saddled animals |
| + | ✅ Baby animals |
| + | ✅ Entities that have picked up items |
| + | |
| + | --- |
| + | |
| + | ## 🌍 Ignored Worlds & Chunks |
| + | |
| + | Some areas or specific coordinates may be exempt from entity checks. These are mostly for admin or event use and should not be relied upon. |
| + | |
| + | --- |
| + | |
| + | ## 🧠 Spawn Reason Controls |
| + | |
| + | The server restricts certain spawn reasons, including: |
| + | |
| + | * **Spawner mobs** |
| + | * **Eggs and dispensers** |
| + | * **Lightning strikes** |
| + | * **Breeding and slime splitting** |
| + | * **Wither and golem builds** |
| + | (Only allowed with permissions) |
| + | |
| + | --- |
| + | |
| + | ## 🧪 Entity Type Limits (Examples) |
| + | |
| + | Each entity type has its own limit. Some examples: |
| + | |
| + | | Entity | Max Allowed | |
| + | | ------------ | ----------- | |
| + | | Blaze | 30 | |
| + | | Axolotls | 20 | |
| + | | Bees | 20 | |
| + | | Warden | 10 | |
| + | | Sheep | 50 | |
| + | |
| + | ➡️ Limits vary by mob. Admins may change these based on server needs. |
| + | |
| + | --- |
| + | |
| + | ## ❗ Tips to Stay Within Limits |
| + | |
| + | * Spread farms across chunks, don't stack everything in one spot. |
| + | * Avoid building mega hopper chains or laggy redstone loops. |
| + | * Breed mobs moderately — especially passive ones. |
| + | * Don't AFK with huge mob groups nearby. |