ClearLag y el lag por entidades en Minecraft: encuentra y limpia lo que sobra

Qué es una entidad y por qué da lag

En Minecraft, entidad es todo lo que no es un bloque: jugadores, animales, monstruos, aldeanos, objetos tirados en el suelo, bolas de experiencia, flechas, vagonetas, soportes de armadura, marcos… El servidor mueve y comprueba cada una muchas veces por segundo mientras está cerca de algún jugador (dentro de la distancia de simulación).

Unas cientos no se notan. El problema son las acumulaciones: una granja que suelta objetos al suelo sin recogerlos, un corral con 300 vacas, un salón de aldeanos enorme, miles de flechas de una granja de esqueletos. Ahí los TPS bajan para todos, aunque el servidor tenga RAM de sobra.

Si no sabes aún si tu lag es de entidades, empieza por spark: cuando el culpable es este, en el informe pesa lo que lleva «entity» en el nombre.

Cuéntalas: cuántas hay y dónde

Paper trae un comando que lo dice sin instalar nada. Desde la consola hay que decirle el mundo: paper entity list * minecraft:overworld enseña cuántas entidades hay de cada tipo en el mundo principal (minecraft:the_nether y minecraft:the_end para los otros). Dentro del juego, como op, vale /paper entity list y mira el mundo en el que estás.

El primer número de cada línea son las que se están simulando ahora (cerca de alguien); el que va entre paréntesis, las que están cargadas pero quietas. Lo que hay que mirar es el tipo que se dispara: minecraft:item (objetos en el suelo), minecraft:experience_orb, minecraft:arrow, un animal concreto o minecraft:villager.

Con un solo tipo te dice dónde: paper entity list minecraft:item minecraft:overworld saca los 10 chunks con más objetos y cuántos tiene cada uno. Las coordenadas que da son de chunk; multiplicadas por 16 son las de bloque (el chunk 12, -40 empieza en el bloque 192, -640). Dentro del juego, al pulsar en la línea te lleva allí.

Sin Paper (Fabric, Forge, NeoForge), el comando del juego execute if entity @e[type=item] dice cuántos objetos sueltos hay en los chunks cargados, sin decir dónde.

Límpialas a mano con /kill

kill @e[type=item] borra todos los objetos tirados en el suelo de los chunks cargados. kill @e[type=experience_orb] hace lo mismo con la experiencia y kill @e[type=arrow], con las flechas. Lo que está en chunks descargados (lejos de todos) no lo toca.

Dentro del juego puedes limitarlo a tu alrededor: /kill @e[type=item,distance=..64] borra solo los objetos a menos de 64 bloques de ti. Es lo más seguro para limpiar la granja que has encontrado con el comando de antes sin tocar el resto del mundo.

Nunca escribas kill @e a secas: mata todas las entidades, también a los jugadores, las mascotas, los aldeanos, los caballos y los soportes de armadura y marcos de las construcciones. Si te pasa, solo lo arregla una copia de seguridad.

Antes de limpiar con gente jugando, avisa con say (por ejemplo, say Limpieza de objetos del suelo en 1 minuto): alguien puede haber muerto y estar volviendo a por sus cosas.

¿Y ClearLag?

ClearLag (y los plugins que lo imitan) hace exactamente lo de la sección anterior, pero solo y cada pocos minutos: avisa en el chat y borra los objetos del suelo y, según cómo lo configures, también otras entidades. Por eso es tan conocido: se instala y los TPS suben.

El problema es que trata el síntoma. La granja que tira 2.000 objetos por hora los sigue tirando, y entre limpieza y limpieza el lag vuelve. Y borra a ciegas: las cosas de un jugador que acaba de morir, lo que alguien ha tirado para pasárselo a un amigo, a veces los animales de un corral. Es la queja más típica de los servidores que lo usan.

Si aun así lo quieres, que sea uno puesto al día para tu versión de Minecraft (muchas copias de ClearLag llevan años sin actualizarse y fallan en las versiones nuevas) y configúralo para que borre solo objetos del suelo y experiencia, nunca mobs con nombre, mascotas ni aldeanos. Antes, prueba los ajustes de la sección siguiente: muchas veces bastan.

Lo que Paper ya hace solo (y cómo ajustarlo)

Un objeto en el suelo desaparece solo a los 5 minutos (6000 ticks) mientras su chunk está cargado. En Paper ese tiempo, y otras cosas que ayudan con las entidades, se cambian en tres ficheros de la carpeta principal del servidor. Se aplican al reiniciar. Haz una copia antes.

spigot.yml, dentro de world-settings → default: item-despawn-rate es el tiempo en ticks que dura un objeto en el suelo (20 ticks son un segundo); bajarlo a 3000 lo deja en 2 minutos y medio. merge-radius → item (0.5 de serie) junta en un solo montón los objetos iguales que están a esa distancia: subirlo a 2.5 hace que una granja deje muchas menos entidades sueltas.

config/paper-world-defaults.yml, en entities → spawning → alt-item-despawn-rate: con enabled: true, los objetos de la lista desaparecen antes que el resto. Viene con cobblestone: 300 (15 segundos) y puedes añadir lo que tus jugadores tiran a montones (netherrack, dirt, cobbled_deepslate…) sin que afecte a las cosas de valor.

En el mismo fichero, chunks → entity-per-chunk-save-limit pone un máximo de entidades de un tipo que se guardan por chunk al descargarlo (de serie, sin límite). Con arrow: 16 o experience_orb: 16, una granja olvidada no acumula miles de flechas o bolas de experiencia de una sesión a otra.

La regla del juego max_entity_cramming (24 de serie) es cuántos mobs caben en un mismo bloque antes de empezar a hacerse daño. Bajarla mata antes a los animales apretujados de una granja: útil contra corrales sin control, pero avisa antes a tus jugadores. Cómo cambiar reglas, en la guía de gamerules.

merge-radius:
  item: 2.5
item-despawn-rate: 3000

chunks:
  entity-per-chunk-save-limit:
    arrow: 16
    experience_orb: 16
entities:
  spawning:
    alt-item-despawn-rate:
      enabled: true
      items:
        cobblestone: 300
        netherrack: 300
        dirt: 300

Arreglar la causa: granjas, corrales y aldeanos

Granjas que sueltan objetos: que todo acabe en tolvas y cofres en vez de en el suelo, o que una corriente de agua lo lleve a una sola tolva. Un objeto dentro de un cofre no es una entidad y no cuesta nada.

Corrales: las granjas de cría crecen sin que nadie las mire. Poned una norma (por ejemplo, 30 animales por corral) en las normas del servidor y revisad de vez en cuando con paper entity list.

Aldeanos: son de las entidades más caras, porque buscan camas, puestos de trabajo y caminos. Un salón de comercio con cada aldeano en su celda de un bloque gasta mucho menos que 50 aldeanos sueltos por un pueblo.

Y si lo que pasa es que el mundo es grande y sois muchos, bajar simulation-distance en server.properties reduce cuántas entidades se simulan alrededor de cada jugador; suele notarse más que cualquier plugin de limpieza.

En NapNodes

Los servidores de Minecraft se entregan en Paper con la última versión, así que paper entity list y spark ya están: escríbelos en la «Consola» del servidor, sin la barra. spigot.yml, bukkit.yml y la carpeta config están en «Archivos»; después de cambiarlos, «Reiniciar». Las reglas del juego, como max_entity_cramming, se cambian también en «Configuración», con el servidor encendido, y se aplican a la vez en el mundo, el Nether y el End.

Si de verdad quieres una limpieza periódica sin instalar nada, en «Configuración avanzada» → «Tareas programadas» puedes crear una tarea «Mandar un aviso a los jugadores» y, un minuto después, otra «Escribir una orden en la consola» con kill @e[type=item], cada pocas horas (lo explica la guía de tareas programadas).

La RAM de tu plan es solo tuya, sin sobreventa: el lag por entidades es de tu mundo y se arregla en tu servidor, no depende de otros clientes. En «Rendimiento» ves las gráficas de procesador y memoria para comprobar si la limpieza o los ajustes han servido.

Preguntas frecuentes