Saltar al contenido principal

Vanilla

346 acciones, eventos, objetivos, hechos, filtros de audiencia y actividades de NPC de Minecraft vanilla.

Gratuitasv1.4Utilidades
RequiereTypeWriter0.9Basic extension (TypeWriter)Quest extension (TypeWriter)Entity extension (TypeWriter)RoadNetwork extension (TypeWriter)PlaceholderAPIopcional
DescargarCódigo fuenteSoporte

Descripción general​

Vanilla conecta las mecánicas estándar de Minecraft con TypeWriter. Es una biblioteca de 346 entradas: acciones que cambian al jugador (atributos, salud, experiencia, modo de juego, velocidad...), eventos que se activan cuando ocurre algo en el juego (suena una campana, se hace un intercambio, se llena un cubo...), objetivos que cuentan esos eventos para las misiones, facts que leen el estado del jugador, filtros de audiencia que coinciden con un estado del jugador y actividades de NPC que hacen que un NPC reaccione a las personas que lo rodean.

Nada se configura en un archivo: añades las entradas que necesitas en el panel web y las enlazas como cualquier otra entrada de TypeWriter. La mayoría de las entradas son pequeñas y tienen pocos campos, así que las páginas de entradas son sobre todo un catálogo; esta página explica las familias y los pocos conceptos que comparten muchas entradas.

Características​

  • Atributos de jugador — 26 acciones que establecen cada una un atributo de Minecraft (velocidad de movimiento, salud máxima, escala, gravedad, alcance...).
  • Acciones de estado del jugador — curar, alimentar, dañar, establecer aire, fuego, vuelo, modo dios, modo de juego, experiencia y nivel, punto de aparición.
  • Acciones de inventario y utilidades — vaciar el inventario, abrir una mesa de crafteo, un yunque, un cofre de ender, un cubo de basura, reparar o condensar minerales.
  • Eventos de juego — 105 eventos, desde interacciones con bloques y contenedores hasta comercio, pesca, asaltos y entrada del jugador.
  • Objetivos — 73 objetivos de misión que cuentan acciones del juego con un fact contador.
  • Facts — 26 facts de solo lectura para salud, hambre, nivel, hora, clima, dimensión, nivel de luz y más.
  • Filtros de audiencia — 48 filtros que seleccionan jugadores por estado: agachado, en movimiento, en el agua, hora del día, coordenadas, herramienta en la mano...
  • Actividades de NPC — 20 actividades para NPC: seguir o evitar jugadores, patrullar, orbitar, detectar jugadores por la vista, el oído o el olfato.
  • Límite de cámara de NPC — fija la cámara del jugador en un NPC durante una interacción.

Instalación​

  1. Instala las extensiones oficiales de TypeWriter Basic, Quest, Entity y RoadNetwork (están declaradas como dependencias de Vanilla).
  2. Descarga VanillaExtension desde las versiones en GitHub (botón de arriba) y coloca el JAR en plugins/Typewriter/extensions/.
  3. Reinicia el servidor. El registro muestra VanillaExtension has been successfully initialized.

La extensión está dirigida a Paper y Folia. PlaceholderAPI no es necesario; solo se usa cuando un campo de texto contiene %placeholders%.

Primeros pasos​

Haz más fuerte al jugador cuando termine un ritual y cuenta cuántos barriles abre para una misión:

  1. En el panel web de TypeWriter, abre una página de sequence y añade una acción como Set Max Health. Establece amount en 30 (el atributo se establece a este valor, no se suma al actual).
  2. Enlázala desde un diálogo u otra entrada mediante triggers para que se ejecute cuando el jugador llegue a ese paso.
  3. Para reaccionar a un evento de juego, añade un evento en una página de manifest, por ejemplo Bell Ring Event, y pon las entradas que se ejecutarán en sus triggers.
  4. Para un objetivo de recuento, crea primero un fact contador (por ejemplo, un fact permanente de la extensión Basic) y luego añade Barrel Objective en una página de manifest. Establece quest, fact con el contador, amount en 5 y display con la línea que se muestra en el rastreador de misiones.
  5. Enlaza onComplete con una secuencia de recompensa, o rellena onCompleteModifiers para cambiar facts cuando se complete el objetivo.
  6. Publish y prueba.
Las acciones de atributo son absolutas

Una acción de atributo establece el valor base del atributo. No se acumula con una llamada anterior y no se restablece por sí sola. Usa los valores por defecto de vanilla para deshacerla: por ejemplo, la velocidad de movimiento es 0.1, la salud máxima es 20 y la escala es 1.

Cómo funciona​

  • Los eventos son triggers simples: añade uno en una página de manifest y rellena triggers. La mayoría no tiene ningún campo y se activa por cada evento coincidente de cada jugador. Algunos tienen filtros (por ejemplo, weather_event tiene un world y una condition, on_player_input tiene un inputType y un heldItem).
  • Los objetivos necesitan un fact contador en fact. Cada vez que el evento de juego ocurre para un jugador de la misión activa, el fact aumenta en uno. El objetivo se completa cuando el fact alcanza amount. Como el progreso vive en un fact, también puedes cambiarlo desde cualquier otro sitio.
  • Los facts son de solo lectura: úsalos en criterios, objetivos y condiciones de diálogo. No se puede escribir en ellos.
  • Los filtros de audiencia mantienen a un jugador en una audiencia mientras el estado sea verdadero, y se pueden invertir. Coloca entradas debajo de ellos para mostrarlas solo a esos jugadores.
  • Las actividades se ejecutan sobre una instancia de NPC y se describen más abajo.

Qué cubre​

Atributos​

26 acciones, cada una establece un atributo del jugador al amount que indiques. Movimiento y combate: Movement Speed, Sneaking Speed, Attack Damage, Attack Speed, Knockback Resistance. Cuerpo y mundo: Max Health, Scale, Gravity, Step Height, Block Reach, Camera Distance.

Salud, hambre y experiencia​

Heal, Heal All, Damage, Feed, Set Hunger, Set Saturation, Set Absorption, Set Air, Set Fire, Freeze, Add Experience, Set Level, Suicide.

Movimiento, física y modos​

Set Velocity (absoluta o sumada a la velocidad actual), Flight, God Mode, Gamemode, Mount Vehicle, Dismount, Eject Vehicle, Wake Up, Set Spawn Point, Top.

Inventario y objetos​

Clear Inventory, Repair, Durability (objeto de la mano principal), Hat, Condense Ores (convierte 9 lingotes, minerales en bruto, gemas o carbón en el bloque correspondiente), Ender Chest, Disposal (abre un cubo de 54 ranuras), Craft, Anvil, e Inventory See / Ender Chest See para abrir el inventario de otro jugador por su nombre exacto.

Mundo, efectos e interfaz​

Create Explosion, Spawn Lightning, Launch Firework, Spawn Tree, Start Raid, Set World Time, Open Book, Open Sign, Clear Title, Grant Advancement y Revoke Advancement.

Eventos​

105 triggers sobre el juego: estaciones de trabajo (Anvil Repair, Enchant, Smelt, Brewing Stand Brew), contenedores y bloques (Barrel Open, Bell Ring, Jukebox Play, Sign Change), el jugador (Player Teleport, Player Respawn, Toggle Sneak, Player Input), animales y comercio (Entity Breed, Villager Trade, Piglin Barter), vehículos, asaltos, pesca, objetos y el mundo (Weather).

Objetivos​

73 objetivos que reflejan los eventos: Gather (objetos en el inventario), Craft, Consume Item, Villager Trade, Harvest Crop, Statistic Reach, Level Reach, Tame Entity, Sleep, Raid Complete y comprobaciones sobre un fact: Cachable Fact Check y Readable Fact Check.

Facts​

Player Health, Player Hunger, Player Level, Game Mode, Armor Value, Current Dimension, Time of Day, Weather, Light Level, Total Play Time, Time Since Death, además de indicadores de en llamas, en el agua, durmiendo, congelándose y en un asalto.

Filtros de audiencia​

Estado del jugador: Sneaking, Sprinting, Moving, Swimming, Gliding, Riding, On Fire, Low Health, Has Effect, Has Armor, Tool in Hand, Weapon in Hand. Lugar y hora: Coordinate, In Specific Dimension, Daytime, Nighttime, Time Period, During Rain, Near Beacon. Vista: Looking At Entity, Looking Up, Looking Down, y los filtros de teclas Forward, Backward, Left y Right.

Actividades de NPC​

Follow Player, Avoid Player, Orbit, Hearing, Smell, Equipment Detection, Health Detection, Line of Sight Obstructed, y la familia de campo de visión: Visibility Detection, Look Close, Patrol, Random Patrol, Spin.

Límite de cámara​

Lock NPC Camera mantiene la vista del jugador en un NPC mientras se ejecuta una interacción (un diálogo).

Configuración​

Vanilla no tiene archivo de configuración. Los objetivos que cuentan (la mayoría de las entradas *_objective) muestran su progreso en el rastreador de misiones con los snippets de TypeWriter advancedQuest.display y advancedQuest.completed, y Gather usa quest.gather_objective.display y quest.gather_objective.completed. Usan los placeholders <display>, <current> y <required>.

Entradas​

La lista siguiente contiene todas las entradas de la extensión, agrupadas por tipo.

346 entradas, generadas a partir del código fuente de la extensión.

Acciones73
Eventos105
Objetivos73
Hechos26
Audiencias48
Actividades20
Límites de interacción1

Solución de problemas​

Una acción de atributo parece no hacer nada, o el efecto se queda para siempre. La acción escribe el valor base del atributo y nada lo restablece. Ejecuta la misma acción con el valor por defecto (por ejemplo 0.1 para la velocidad de movimiento) para deshacerla. Minecraft limita algunos atributos (por ejemplo la escala), y un valor fuera de rango se rechaza con un error en el registro del servidor.

Un objetivo nunca se completa. Necesita un fact que sea un contador (un fact con caché escribible, como un fact permanente o de sesión), una quest activa para el jugador y criteria que coincidan. Los facts de solo lectura (todas las entradas de la carpeta fact) no se pueden usar como contador.

Un evento repetido de comprobación de fact con caché sigue activándose. Cachable Fact Check Event vuelve a comprobar cada checkIntervalSeconds (por defecto 10) y se activa cada vez que el fact sigue coincidiendo. Establece un modificador que cambie el fact, o úsalo con una protección de un solo uso. Un valor de 0 desactiva la comprobación periódica, y un intervalo negativo se rechaza con un error en el registro.

Una actividad de visibilidad nunca detecta al jugador. El NPC debe verse como una instancia de entidad con la actividad establecida, el jugador debe estar dentro de radius (o visionRadius) y dentro del fov de la orientación del NPC, y no puede haber ningún bloque en medio. La detección se activa una vez cuando el jugador entra en el campo de visión y de nuevo solo después de que salga y vuelva. Activa showDisplay para ver el cono en partículas de llama.

Un evento se activa para todos. Los eventos sin campos (la mayoría) no se filtran: cada evento coincidente activa las entradas enlazadas para el jugador que lo causó. Usa criteria en las entradas que activan para restringirlas.

Abrir el inventario de otro jugador no hace nada. Inventory See y Ender Chest See necesitan el nombre exacto de un jugador conectado en target. Un objetivo vacío abre el inventario del propio jugador, y un nombre desconocido no hace nada.