Cómo dar un kit inicial de Minecraft a los jugadores nuevos en tu servidor Paper

Qué hace un kit inicial de Minecraft en la primera conexión

El kit de esta guía es una espada de piedra, un pico de piedra y 16 panes, seguido de una línea de chat privada que le dice al jugador nuevo lo que acaba de recibir. Se entrega automáticamente cuando un jugador entra en tu servidor por primera vez. No hay que escribir ningún comando ni configurar ningún permiso.

Aquí, "primera vez" significa lo que Paper ya sabe: un jugador que el servidor nunca había guardado antes de que se conectara. El runtime no lleva ninguna lista propia ni ningún contador. Por eso el kit funciona en un servidor que ya tienes en marcha, y también por eso no puede hacer algunas cosas, que verás más abajo.

Esta receta usa el editor de bloques de NimBlock y su runtime aparte y gratuito. Con una cuenta de NimBlock puedes guardar la regla. Para usarla, necesitas un servidor de Minecraft Java que ya exista y cuyo hosting permita subir plugins. Los pasos de abajo son para Paper 1.21.11 con Java 21. No necesitas un servidor alojado en NimBlock.

Crea la regla del kit en el estudio

1. Abre tus plugins en NimBlock y crea un plugin nuevo. El editor empieza con una regla de bienvenida; puedes dejarla o borrarla.
2. Desde Reglas, arrastra una regla nueva al plugin y llámala Kit inicial.
3. Desde Desencadenantes, pon Un jugador se conecta en su hueco cuando.
4. Desde Condiciones, pon Es la primera vez del jugador en su hueco si.
5. Desde Acciones, añade Dar un objeto al jugador tres veces: STONE_SWORD con cantidad 1, STONE_PICKAXE con cantidad 1, BREAD con cantidad 16.
6. Añade Enviar un mensaje al jugador al final, por ejemplo ¡Bienvenido, {player}! Aquí tienes un kit inicial para empezar. Deja {player} tal cual: el runtime lo cambia por el nombre del jugador.
7. Guarda el plugin. En su página, copia el JSON completo que aparece en un archivo de texto plano llamado starter-kit.json, guardado en UTF-8.

Los objetos se escriben con su nombre de Minecraft, como IRON_AXE o COOKED_BEEF. Cambia los tres objetos por los de tu propio kit: una acción por objeto, cada una con su cantidad. La gramática pública muestra todos los desencadenantes, condiciones y acciones disponibles.

Instálalo en tu servidor Paper

1. Descarga el runtime de NimBlock. Detén el servidor, pon el .jar del runtime directamente en plugins/ y luego inicia el servidor.
2. Comprueba que NimBlock está activado con /plugins. La guía de instalación de plugins de Paper explica cómo averiguar por qué no se ha cargado.
3. Sube starter-kit.json a plugins/NimBlock/specs/. Respeta las mayúsculas del nombre de la carpeta. Si hace falta, crea la carpeta antes.
4. Como operador del servidor, ejecuta /nimblock reload y luego /nimblock list. Debería aparecer el nombre del plugin que guardaste. En la consola del servidor, escríbelos sin la barra del principio.

Corrige cualquier error que salga durante la recarga antes de probar. Un nombre de objeto desconocido solo se detecta cuando la regla se ejecuta, así que revisa cómo está escrito cada objeto antes de tu primera prueba.

Pruébalo con una cuenta que nunca haya entrado

Tu propia cuenta ya ha jugado en tu servidor, así que no recibirá el kit, y eso significa que la regla funciona bien. Prueba con una cuenta de Minecraft Java que nunca haya entrado en este servidor, por ejemplo la de un amigo, o en una copia de tu servidor con un mundo nuevo. En esa primera conexión, la cuenta debería recibir la espada, el pico, el pan y el mensaje. Desconéctate, espera un momento y vuelve a conectarte: no debería recibir nada más.

Los jugadores que entraron antes de que instalaras la regla no son nuevos y no recibirán el kit. Cargar la regla no vuelve a procesar las entradas anteriores.

Los límites de un kit de primera conexión

• Una vez por jugador, mientras el servidor lo recuerde: la condición lee los datos de jugador del propio Paper. Si empiezas un mundo nuevo, todos vuelven a ser nuevos y reciben el kit otra vez. Si borras los datos de un jugador, solo ese jugador vuelve a ser nuevo y recibe el kit de nuevo.
• Se cumple durante toda la primera sesión: la condición es verdadera no solo en el momento en que el jugador nuevo entra, sino hasta que se desconecta, aunque el servidor lo guarde mientras tanto. Déjala bajo Un jugador se conecta; con otro desencadenante, como reaparecer, un jugador nuevo podría recibir el kit una segunda vez durante esa primera sesión.
• Sin kit diario, sin tiempo de espera, sin contador: el runtime reacciona a eventos y no recuerda nada, así que no puede dar un kit "una vez al día" ni "tres veces por jugador".
• Objetos simples: la acción da un tipo de objeto y una cantidad. Los encantamientos y los nombres personalizados no entran.
• Inventario lleno: lo que no cabe cae al suelo a los pies del jugador. El inventario de un jugador nuevo suele estar vacío, así que casi nunca importa.

Cambia el kit sin reinstalar el runtime

Edita la regla en el estudio y guarda una versión nueva. Sustituye el contenido del mismo archivo starter-kit.json por el JSON recién guardado y luego ejecuta /nimblock reload. El siguiente jugador nuevo recibe el kit nuevo; los que ya recibieron el antiguo no reciben nada más. Si dejas el archivo antiguo y el nuevo, se cargarán las dos reglas y se entregarán dos kits.

Puedes usar el runtime en tu propio servidor Paper compatible sin contratar el hosting de NimBlock. Tu regla sigue siendo un archivo JSON legible que puedes revisar y guardar con la copia de seguridad de tu servidor.