Z-Points

Trusted Free Z-Points 1.3.1

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.

This release brings together the changes of 1.1.0, 1.2.0 and 1.3.0. If you come from 1.0.x, read "Upgrading from 1.0.x" in the description before you update, and back up your config.json first.

New config structure (1.1.0)
  • config.json now holds the settings only (switches, click timings, step sizes, limits). It no longer contains any sentence read by players, and the plugin never writes to it.
  • Every setting is explained in config.commented.json, shipped with the plugin and replaced at each update. It is the documentation: read it, do not rename it to config.json.
  • The texts players read are in the lang folder: en.json, fr.json, de.json, es.json. They are replaced at each update, so do not edit them.
  • Your own texts go in lang\custom.json. It is never shipped and never overwritten by an update. Format: {"EN": {"ZpOn": "your text"}, "FR": {"ZpOn": "votre texte"}}. A key you leave out keeps the shipped text.
  • To add a language, create lang\nl.json (or any 2 or 3 letter code) with the same keys as en.json, or add an "NL" block in custom.json.
  • A file that cannot be read (invalid JSON) is ignored with a warning in the log. Nothing is written.
  • The old Texts block of config.json is no longer read. Copy the texts you changed into lang\custom.json, under their language. With Z-ARK 0.285.0 or newer this is done for you at install, after a safety copy.
  • ZPoints.Reload re-reads config.json and the lang folder. ZPoints.Status now ends with the texts loaded, for example "texts: lang EN FR DE ES, custom FR:2".

Texts in the language of each player (1.1.0)
  • A message meant for one player is sent in that player's own language (the flag chosen in the ZMenu mod, carried by Z-Bridge) when the plugin has texts for it. Otherwise it uses the server language, General.Language.
  • Search order for a sentence: lang\custom.json in the player's language, the shipped file of that language, custom.json in English, en.json, then the English text built into the plugin. A player never gets an empty message.

Where messages show (1.2.0 and 1.3.0)
  • 1.2.0 added three ways to see the short messages: in the chat, at the top of the screen, or both. Both is the default.
  • 1.3.0 hands this choice over to Z-Messages (1.2.0 or newer). Each player types /msg both, /msg chat or /msg top (/msg alone shows the current choice). The choice is remembered by Z-Messages, per player, for all our plugins at once. The server default is PlayerDisplay.Default in the Z-Messages config (shipped: both).
  • /zp msg <word> still works: it is now just another way to type /msg. It works even after a player typed /zp off.
  • A player who had chosen /zp msg chat with an older version is imported once by Z-Messages from the old msgstyle.json file, which the plugin no longer uses.
  • The help lists (/zp, /points) always go to the chat, because several lines at the top of the screen would be unreadable.
  • Without Z-Messages 1.2.0 or newer, messages go to the chat and to the top of the screen, and /zp msg answers with a short explanation.
  • The PlayerMessages block that existed in 1.2.0 is gone: nothing to set in config.json for this any more.

Other
  • Safer unload (1.1.1): when the server unloads the plugin, it now gives back the crash handler it set up at start.
  • Setting names are the same as in 1.0.x: no new setting to add to your config.json. The plugin no longer renames old setting names by itself (it no longer rewrites config.json), and General.Langue is no longer understood: use General.Language.
  • Texts shipped in English, French, German and Spanish.
Fix: when the typed commands are switched off (ChatCommands.Enabled = false), /points no longer advertises /lvl and /dlvl, and typing /lvl or /dlvl now shows the help instead of doing nothing.
Config unchanged. AsaApi 2.11 or newer (ARK 97 / Unreal Engine 5.8).
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.
  • Like
Reactions: borgames
  • A shoulder pet is never taken as the aimed dino.
  • Stat names from the French, German and Spanish help are accepted, accents included.
  • Messages follow each player's language once the multilingual ZMenu is released.
Back
Top