Hytale Server API Reference: Mga Pangyayari, Mensahe, at Plugin Development Guide

Pag - unawa sa Hytale Server Arkitektura Ang Hytale server API ay itinayo sa isang matipunong Java-based na arkitektura na magiging pamilyar sa sinumang nagtrabaho sa Minecraft server pluins. Sa pagbabalik sa Legacy Engine, ang mga developer ngayon ay may access sa isang magulang at mahusay na tested codebase na nagbibigay-diin sa modibility sa cross-platform complex. Sa puso ng server ay nakaupo ang com.hypixel.hytale.server.core pakete, na nagbibigay ng pundasyon para sa lahat ng mga operasyon ng server-side. Kabilang dito ang pamamahala ng manlalaro, pangangasiwa sa daigdig, pagpapadala ng mga pangyayari, at pagproseso ng utos. Mga Pangyayari ng Player Connect: Pagharap sa Pagsama at Dahon Isa sa pinakakaraniwang kahilingan para sa anumang server plagin ay ang pagtugon sa mga manlalaro na sumasali o umaalis. Ang Hytale API ay nagbibigay ng dalawang mahahalagang pangyayari para sa layuning ito. PlayerConnect vent Fired kapag ang isang manlalaro ay matagumpay na kumokonekta sa server, ang pangyayaring ito ay nagbibigay sa iyo ng makukuhang reperensiya sa player bago sila ganap na mangitlog sa daigdig. Kabilang sa mga pangunahing katangian ang: playerRef - Ang PlayerRef Halimbawa na naglalaman ng UUD, username, at network info player - Ang Player entity na kakatawan sa kanila sa mundo wdeworld - Ang World case na pinagsasanib nila holder - Ang entity na may laman para sa bahaging access Tulad ng iba pang mga pangyayari, PlayerConnect Ang tuldok ay not cancellable. Kung kailangan mong hadlangan ang isang manlalaro na sumali, dapat mong pangasiwaan ito sa tunay na suson sa halip na. < Pre>evitRegistry. register(PlayerConnect ult: Class.java) { event -> val player = kaganapan.playerRef loger.info("Player konektado: $ $.username}") // Magpadala ng malugod na mensahe Ang manlalaro.sendMessage(Message.raw("Pagtanggap sa server!") EX Player Disnect Advent Triggered kapag ang isang manlalaro ay umaalis sa server, kabilang sa pangyayaring ito ang mahalagang konteksto tungkol sa dis connectReason - Enum na nagpapahiwatig ng timeout, pagsipa, paghinto, o server diver Ang pangyayaring ito ay hindi rin-cancellable mula nang maganap ang di-pag-uugnay sa antas ng network. The Message Class: Rich Next Formating Ang mga may - ari ng pasilidad na naghahanap ng mapakinis na mga karanasan sa pakikipag - usap ay gugugol ng malaking panahon sa klase ng Mensahe. Matatagpuan sa core messaging package, nagbibigay ito ng isang matatas na API para sa pormasyon ng pagtatayo. Basic Message Creation >evitRegistry. register(PlayerInteract Advent: Class.java) { event -> kung (kulang. action) Type ==ActionType.RIGHT_CLICK) { // Iproseso ang interaksiyon pangyayari.setCancelled(tunay) } EX Asynchronous Registration Para sa mga pangyayaring maaaring iproseso mula sa pangunahing sinulid (katulad ng chat limit): >eventRegistry.registerAsync(PlayerChat ult: Class.java) { hinaharap -> sa hinaharap. Pagkatapos ay angkop na { -> // Gumawa ng async chat filtering kung (containsBanned Swords(event.content) { pangyayari.setCancelled(tunay) } pangyayari } EX Common Pangyayari Reference Table Narito ang isang mabilis na pagtukoy sa pinakamadalas gamiting mga pangyayari sa paggawa ng server: Kakaibang> Pangalanth>Cancellable Mga Pangunahing Karapatan PlayerConnect Advent NoplayerRef, manlalaro, mundo, may-akda Player Disnect Advent NoplayerRef, i-disnectReason PlayerChat Advent PlayerRespawn Advent> Noplayer/tr> BreakBlock Adventval commandManger = CommandManger.get() commandManarger.handleCommand(sender, "panahong araw") Plugin Lifecycle at Structure Tuwing Hytale server plagin ay pinalawig ang klaseng base sa JavaPlugin, na nagbibigay ng mahahalagang registry at mga pangawit na lifecycle. Plugin Lifecycle Phases Construction - Plugin class instantiation PreLoad - Async paunang pag-uumpisa ng server Seteup