Cómo construir Minijuegos personalizados en Hytale: Guía para Desarrolladores de Servidores

La arquitectura del lado servidor de Hytale lo hace únicamente adecuado para minijuegos personalizados. A diferencia de Minecraft donde los plugins del modo de juego luchan contra la caja de arena de vainilla, Hytale API plugin y ECS le dan control directo sobre el comportamiento de las entidades, estado mundial y flujo de juego. Si has construido minijuegos Bukkit, los conceptos se traducen, pero la implementación es más limpia. Identificado Esta guía cubre los sistemas básicos cada necesidad de minijuegos: gestión del estado del juego, instancias de arena, seguimiento del jugador, puntuación, matchmaking, y despliegue. > > Cómo funcionan los plugins de Minijuegos en Hytale obtenidos/h2 titulado Antes de bucear en código, entender la arquitectura de alto nivel de un minijuego Hytale: ■table - No. < < < < < > > > > > > > > ■/thead título Identificado - No. todo — crea arenas, administra lobbies, los jugadores de rutas realizadas/td Queríatd confianzaSingleton servicio en su plugin seleccionado/td titulado - No. Una sesión de juego en marcha con su propio estado, jugadores y la región del mundo seleccionó/td fieltroClass administrando un mundo o región < > > > > > > > > > > > > > > > > > > > > > > > < > > > > > > > > > > > > > > } > } > } Componentes adjuntos a las entidades del jugador - No. Reaccionar a acciones de jugador: matar, bloquear rupturas, la entrada de la zona seleccionada/td fieltroEventBus + sistemas de eventos ECS Identificado/tbody ■/table ■h2 títulos 1: Máquina del Estado del Juego Cada minijuego necesita una máquina estatal. Esta es la columna vertebral que controla lo que sucede y cuándo. ▪pre instrucciones especificado código público enum GameState {} WAITING, // Lobby, esperando a los jugadores STARTING, // Cuenta atrás antes de comenzar el juego PLAYING, // Juego activo DEATHMATCH, // Opcional: fase de desplegable final ENDING // Juego terminado, mostrando resultados } buscado/código asignado Cada instancia de arena tiene su propio código: Las transiciones ocurren sobre la base de condiciones: Identificado √Īo: Cuenta de jugador mínimo alcanzada нелинанилинититинитиная → PLAYING: El temporizador de cuenta atrás caduca No se puede decir nada. Límite del tiempo o umbral del jugador > < > > > > > > > Condicion de ganancia encontrada (último jugador vivo, puntuación alcanzada, etc.) "Seguido" Resultados mostrados, reajuste de la arena ■/ul contacto Identificar el código público Arena {} Estado del juego privado = Estado del juego. Esperando; final privado List limitada;PlayerRef sensible; players = nuevo ArrayList golpelt; ppgt;(); cuenta regresiva privada = 10; public void tick() {} cambio (estado) { caso WAITING - confía { si (jugadores.size() MIN_PLAYERS) { estado = Estado del juego. STARTING; Cuenta atrás = 10; } } case STARTING - confiar { cuenta atrás... broadcastCountdown (countdown); si estado = Estado del juego. Aplausos; startGame(); } } caso PLAYING - título { checkWinCondition(); } caso ENDING - propiedad { displayResultados(); resetArena(); estado = Estado del juego. Esperando; } } } } buscado/código asignado ■h2 títuloStep 2: Datos de los jugadores con componentes ECS obtenidos/h2 título ■Pruebe el sistema de componentes de la Entidad de Hytale para adjuntar datos específicos del juego a las entidades del reproductor. Esto es más limpio que mantener externo HashMap Convenlt;UUID, PlayerData duplicagt; mapas seleccionados/código confianza — los datos viven en la propia entidad. Identificar código de clase pública Minigame Jugador implementa Componente limitado; Entidades public String arena Id = "; public String team = ""; int public kills = 0; muertes por int público = 0; puntuación de entrada pública = 0; booleano público vivo = verdadero; publico largo Muerte = 0; @Override public MinigamePlayer clone() { Minigame Reproductor copia = nuevo MinigamePlayer(); copy.arena Id = this.arenaId; Copia. equipo = este equipo; copy.kills = this.kills; copy.deaths = this.deaths; copy.score = this.score; copy.alive = this.alive; copy.lastDeath = this.last Muerte; copia de devolución; } } buscado/código asignado ■p Confeccionar este componente cuando un jugador se une a una arena, leerlo durante el juego de puntuación y la lógica del equipo, y eliminarlo cuando se vaya. *2 títulos 3: Manejo de eventos para el juego Logic ■p]Minigames necesita reaccionar a las acciones del jugador. Utilice el sistema de eventos adecuado para cada tipo: ▪h3 Eventos de autobuses (Global) Identificado pre-concepto El jugador se une al servidor — mostrarles el vestíbulo getEventRegistry().registerGlobal() PlayerReadyEvent.class, evento - título teleportToLobby(event.getPlayer())) ); // Desconexión del jugador — quitar de la arena getEventRegistry().registerGlobal() PlayerDisconnectEvent.class, evento - Empuñadura de contactoPlayerLeave(event.getPlayer()) ); // Chat comandos — /join, /leave, /spectate getEventRegistry().registerAsyncGlobal() PlayerChatEvent.class, futuro - edad futura.entoncesAcept(evento - edad { String msg = event.getMessage(); si (msg.startsCon("/join") {} event.setCancelled(true); handleJoinCommand(event.getSender()); } }) ); ▪h3 Eventos (Entity-Specific) Identificado Para roturas de bloques, daños y otras acciones a nivel de entidad, crea el código clave titulado EntityEventSystem seleccionado/code contactos subclases: Identificado pre-concepto La pista mata para anotar clase pública KillTracker extensivos RefChangeSystem reducidalt;EntityStore, DeathComponent golpeadogt; { @Override vacío público enComponente Añadido (EntityStore store, Ref entity, DeathComponent death) { // Entity murió — encontrar al asesino, actualizar las puntuaciones Ref killer = death.getKiller(); si (asesino!= nulo) { Minigame Jugador asesinoData = getComponent( asesino, MinigamePlayer.class); si (killerData != null) { asesino Data.kills+; asesino Data.score += KILL_POINTS; } } } } buscado/código asignado *Recordar: Los eventos del ECS deben ser cancelados en la fase de la inspección. Si desea evitar que se rompa el bloque durante la fase del vestíbulo, el filtro debe comprobar el estado del juego y cancelar antes de que la acción ejecute. ■h2 títuloStep 4: Gestión de la arena Identificado Para juegos que necesitan espacios de juego aislados (juegos de hambre, guerras de camas), usted necesita instancias de arena: < > > > } > > > } {} final privado Mapa limitado;String, Arena limitada; arenas = nuevo HashMap plagalt; curvagt;(); public Arena createArena(String id, Location center) {} Arena arena = nuevo Arena(id, centro); arenas.put(id, arena); arena de retorno; } public Arena encontrarAvailableArena() {} volver arenas.values().stream() .filter(a - título a.getState() == GameState. Esperando. .filter(a - título a.getPlayerCount() .findFirst() .orElse(null); } public void tickAll() { arenas.values().forEach(Arena::tick); } } buscado/código asignado > > Después de cada juego, la arena necesita regresar a su estado original. Dos enfoques: Identificado No se trata de una restauración: Guarde los datos de bloqueo de la región de la arena antes de que comience el juego, restaurarlo después. Usa más memoria pero es confiable. ■li consistio obtenidosstrong confianzaPrefab reload: Utilice el sistema de Prefab incorporado de Hytale para almacenar la arena como una estructura prefabricada y reemplazarla después de cada juego. Limpiador e integra con las herramientas nativas de Hytale. ■/ul contacto < > > > > > > > Asignación del equipo correspondiente cedida de vacío pública Equipos (Arena arena) {} Lista límite;PlayerRef sensible; jugadores = arena.getPlayers(); Collections.shuffle(players); String[] teams = {"Red", "Blue", "Green", "Yellow"}; para (int i = 0; i) i++) { Minigame Datos del reproductor = getComponent( jugadores.get(i), MinigamePlayer.class); data.team = equipos[i % teams.length]; } } buscado/código asignado - No. יp]Use Hytale's Hycode contactosMessage seleccionado/código de propiedad para pantallas de puntuación formateadas. El sistema de mensajes es compatible con el formato de color, estilos audaces/italicos y sustitución de parámetros: Identificar el código del vacío público Puntuación (Arena arena) { StringBuilder sb = nuevo StringBuilder("§6===== Scoreboard ===\n"); arena.getPlayers().stream() .sorted(a, b) - título getScore(b) - getScore(a)) .porCada(p) Minigame Datos del reproductor = getComponent( p, MinigamePlayer.class); sb.append(String.format()§f%s: §e%d kills §7 habit §a%d pts\n", p.getUsername(), data.kills, data.score)); }); arena.broadcast(sb.toString()); } buscado/código asignado > > > > > > > > Cómo implementarlas: ■table - No. < < > > > > > > > > > > ■/thead título Identificado No sé. < > > > > > > > Actualización de puntuación: umbral de comprobación realizado/td titulado < > > > > > La puntuación más alta cuando el tiempo caduca correctamente/td Dijotd instrucciones garrapatas — tiempo de comprobación efectuado/td No. Tareas específicas completas (insignia de captura, cama de destrucción) seleccionadas/td instrucciones especificadoIniciar sesión ECS para la interacción objetiva - No. Lo mejor de N rondas realizadas / td Dijotd usuarioAccionador de extremos de Round — puntuación de la serie de verificación realizadas / td Identificado/tbody ■/table < > > > > > > Para servidores que ejecutan múltiples juegos concurrentes, implemente un sistema de cola: ▪pre instrucciones especificado clave de clase pública Queue {} final privado Queue limitada;PlayerRef sensible; queue = new LinkedList reducidalt; ppgt;(); privado final int requerido Jugadores; public void addPlayer(PlayerRef player) { queue.add(jugador); checkQueue(); } checkQueue() { si (queue.size() {} Arena arena = arenaManager.findAvailableArena(); si (arena != null) { para (int i = 0; i) Jugadores; i+) { PlayerRef player = queue.poll(); arena.addPlayer(jugador); } } } } } buscado/código asignado El sistema integrado por Hytale, creado por el usuario, permitió a los jugadores agruparse y permanecer juntos en las transferencias del servidor. Su emparejamiento debe respetar a los grupos del partido — los miembros del partido de la cola juntos y colocarlos en el mismo equipo cuando sea posible. ■h2 títuloExisting Minigame Mods to Study won/h2 confianza Identificado No construir a partir de cero — estudiar lo que ya está en CurseForge: ■table - No. - No. Tipo seleccionado/t] Características claves para el estudio realizado/t ■/thead título Identificado > > No. PvE Arena seleccionada/td denominadas tiendas de contratos de propiedadNPC, cofres de botas por jugador, patrones configurables seleccionados/td titulado - No. No se puede hacer nada. Identificado/tbody ■/table El mod Juegos de Hambre vale la pena estudiar — demuestra el ciclo de vida completo de un minijuego competitivo: lobby → cuentadown → PvP → deathmatch → resultados → reset. Características de la plataforma para servidores minijuegos realizados/h2 Identificado Hytale proporciona varias características fuera de la caja que los servidores Minecraft necesitan plugins para: seleccionada/p confidencial Identificado لелинитититинитити Catalogue: Construido en el menú principal: los jugadores pueden encontrar su servidor de minijuegos sin sitios de lista externos Sistema: Grupo de amigos nativos que persiste en las transferencias del servidor No se trata de nada. Construido en el cliente para servidores que quieren monetizar cosméticos o perks Marco de permisos: Permiso de nivel de usuario, basado en grupos y comodín que coincida con el título ■/ul contacto > > Identificado Construir su JAR: se realizó/fuerte títulos clave./gradlew build obtenidos/code contactos No se trata de nada. Suelta en el codificador especificado%AppData%/Roaming/Hytale/UserData/Mods/seguido/código titulado > > Actualización 4 permite múltiples instancias de Hytale en un PC — escenarios de prueba multijugador localmente seleccionados/li > > > > "Seguido" Paquete como un plugin con el código apropiado "Seguido" Añadirlo a la etiqueta "Minigames" para que los jugadores puedan encontrar tu título/li título Identificado/oltimo Identificado Para los conceptos fundamentales de API de plugins esta guía se basa, lee nuestra guía "href="/noticias/hitale-modding-api-servidor-plugin-desarrollo-guía"ConferenciaModding API Guide made/a confidencial. Y para la creación de contenido sin código que complemente tus plugins, echa un vistazo a nuestro "href="/noticias/hitale-visual-scripting-guide-no-code-modding" Guía de scripting visual realizada/a confidencial. ¿Construyendo un servidor minijuego? Compártelo en nuestra discordia — contamos con creaciones comunitarias regularmente