How to Reduce Entity Lag (Item Frames, Armor Stands)

Why Entities Cause Lag

Every entity in Minecraft is ticked every game tick. That includes mobs, but also item frames, armor stands, dropped items, boats, minecarts, experience orbs, and projectiles. On decorated servers with hundreds of item frames or armor stand holograms, entity processing can dominate your tick time. Learning to reduce entity lag minecraft server-wide is one of the most impactful optimizations you can make.

Common Entity Lag Sources

• Item frames: Each item frame is an entity. A shop wall with 200 item frames means 200 entities ticked every tick. Glow item frames are even heavier because they require additional rendering data.
• Armor stands: Used for holograms, custom models, and decorations. A hologram plugin creating 5 armor stands per NPC across 50 NPCs adds 250 entities.
• Dropped items: Mob grinders and farms that let items pile on the ground create lag. Hundreds of dropped item entities are expensive.
• Experience orbs: Large farms produce thousands of XP orbs. Each orb is a separate entity until merged.
• Minecarts and boats: Unused vehicles left around the world accumulate over time.

Paper Settings for Entity Optimization

Paper provides several settings in paper-world-defaults.yml to reduce entity lag minecraft server owners deal with:

Item Merging

entities:
  spawning:
    alt-item-despawn-rate:
      enabled: true
      items:
        cobblestone: 300
        netherrack: 300
        dirt: 300

This makes common junk items despawn faster, reducing ground clutter.

Experience Orb Merging

entities:
  behavior:
    experience-merge-max-value: 2147483647

This lets XP orbs merge into a single entity with a huge value instead of existing as hundreds of individual orbs.

Entity Activation Range

entity-activation-range:
  animals: 16
  monsters: 24
  raiders: 48
  misc: 8
  water: 8
  villagers: 24

Entities outside their activation range are ticked less frequently, saving CPU. See Paper settings explained for full details.

Reducing Item Frame and Armor Stand Lag

To reduce entity lag minecraft server setups with heavy decoration:

• Use display entities (1.19.4+): Text displays and item displays are lighter than armor stands and item frames for decorative purposes.
• Limit item frames per chunk: Set a reasonable cap with a plugin or building guidelines. 20-30 per chunk is a practical limit.
• Replace armor stand holograms with text displays: Modern hologram plugins support display entities which have lower tick overhead.
• Remove invisible armor stands: Some plugins leave orphaned armor stands. Use a cleanup command periodically.

Automatic Cleanup

Configure automatic entity cleanup to prevent accumulation:

• Set item despawn rates in Paper config for common block drops.
• Use /kill @e[type=item] on a schedule for extreme cases.
• Clear unused boats and minecarts with a periodic task.
• Limit villager counts per chunk, as villagers are among the heaviest entities to tick due to pathfinding and trading logic.

See an optimized server in action: Astroworld MC, IP play.astroworldmc.com, Java + Bedrock.

Measuring Entity Impact

Run /spark profiler start and check the entity tick breakdown. If entityTick or specific entity types dominate the report, you have an entity lag problem. Use /spark health to see total entity counts. Anything above 2000 total entities in loaded chunks warrants investigation.

Cross-reference with our lag diagnosis checklist to confirm entities are your primary bottleneck before making changes. To reduce entity lag minecraft server performance issues, always measure first.