Z-Messages

Trusted Free Z-Messages 1.2.3

This resource is free
FIXED
  • Package refreshed: the previous file was out of date and now declares AsaApi 2.11 as minimum.
IMPORTANT, read before you install: the architecture of this plugin has been reworked and its configuration files have changed (config.json now holds the settings only, the texts move to a new lang folder, every setting is explained in config.commented.json). Read the new config files and these notes before you install, back up your config.json, and do not overwrite your old config.json without looking at it first.

Back up your config.json before updating from 1.0.1. The plugin is now configured in a new way (details below and in the description, section "Upgrading from 1.0.1").

NEW in 1.2.2: the invitation "Type /zlink to link your Discord account to your character." is now shipped in English, French, German and Spanish. It is added to the welcome message only if the Z-Chat plugin (which provides /zlink) is loaded on the server, and only for players who are not in Welcome.LinkedAccounts (a list filled by Z-ARK; without Z-ARK, fill it by hand). WelcomeIfNotProtected stays empty by default.

NEW in 1.2.1: the welcome message and the announcements follow the choice of each player (/msg), and reach each player in their own language (the flag chosen in the ZMenu mod, passed on by Z-Bridge; otherwise the language of the server). The look (colour, size, duration, sender) stays the one you set; a message set to Panel true stays a panel. The text is now composed at the moment it is sent, for each player.

NEW in 1.2.0: the /msg command. Each player chooses where short plugin messages show: /msg both (chat and top of the screen, the default), /msg chat or /msg top. /msg alone shows the current choice; the words are also understood in French, German and Spanish. The choice is saved per player in display.json. New settings: PlayerDisplay.Default (the choice until a player makes one) and Style.TopOfScreenMaxLength (a text longer than this, 80 by default, goes to the chat only). Choices already made with Z-Points are imported once. New functions for plugin authors (ZMsg::DireSelonJoueur, ZMsg::ChoisirAffichage). ZMessages.Status now shows the display default and the number of players per choice.

CHANGED in 1.1.0: new configuration architecture, shared by all our plugins. config.json holds the settings only. Every sentence players read is in the lang folder (en.json, fr.json, de.json, es.json, replaced at each update), and your own texts go in lang\custom.json (never shipped, never overwritten). Every setting is explained in config.commented.json, shipped with the plugin.
  • AutoMessages.Messages is now a list of text keys: "AutoMessage1", or {"Key": "AutoMessage1", ...} with its own look, OnlyIfNotLinked and OnlyIfBaseNotProtected. An element without a Key is skipped, and reported once in the server log.
  • The welcome texts are the keys WelcomeText, WelcomeIfNotLinked and WelcomeIfNotProtected.
  • The plugin no longer reads the old texts of config.json (Welcome.Text, Welcome.TextIfNotLinked, the Texts block, sentences inside AutoMessages.Messages) and never rewrites config.json. Move your texts to lang\custom.json. Z-ARK 0.285.0 or newer does it for you at update.
  • New style "chat" (used by Z-Chat). The formatting guide is now README.md (it replaces FORMATTING-EN.txt and its translations).
  • ZMessages.Reload answers "reload FAILED, previous settings kept" if config.json cannot be read; ZMessages.Status ends with the languages loaded.
Rebuilt and checked for ARK 97 (Unreal Engine 5.8). No functional change, config unchanged. As with every plugin on 5.8, AsaApi must have published the offsets for your ARK build.
Back
Top