Skip to main content
Performance

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

Practical techniques to reduce entity lag from item frames, armor stands, dropped items, and other non-mob entities on Minecraft servers.

5 min read7 sectionsJava & Bedrock1.21

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.

Questions about Reduce Entity Lag (Item Frames

What exactly is Reduce Entity Lag (Item Frames doing here?

That includes mobs, but also item frames, armor stands, dropped items, boats, minecarts, experience orbs, and projectiles.

How much does Reduce Entity Lag (Item Frames actually need?

Anything above 2000 total entities in loaded chunks warrants investigation.

Which file does Reduce Entity Lag (Item Frames change?

Paper provides several settings in paper-world-defaults.yml to reduce entity lag minecraft server owners deal with: This makes common junk items despawn faster, reducing ground clutter.

Which Minecraft version does Reduce Entity Lag (Item Frames apply to?

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.

How to Reduce Entity Lag (Item Frames, Armor Stands): Practical techniques to reduce entity lag from item frames, armor stands, dropped items, and other non-mob entities on Minecraft servers.
How to Reduce Entity Lag (Item Frames, Armor Stands), from the Performance guides on Astroworld.

Blocks and items in this guide

Glow Item Frame in MinecraftGlow Item FrameCobblestone in MinecraftCobblestoneItem Frame in MinecraftItem FrameNetherrack in MinecraftNetherrackMinecart in MinecraftMinecart

All 5 of these are named in the Reduce Entity Lag (Item Frames guide above, starting with Glow Item Frame. Look them up in the item database.

More guides on this site

More Performance Guides

Related Tools & Databases