User Tools

Site Tools


zxt:extension:0000a51e:0006

0000a51e:0006 - OOP command renaming [DRAFT]

Flags

Flag Set? (MUST/MAY/…) Description
parsing_must MUST NOT
reading_must MUST NOT
writing_must MUST NOT
playing_should SHOULD
playing_must SHOULD
editing_should MUST NOT … What about syntax highlighting?

Field data

Offset Type Description
0 u16 Number of commands to rename.
2… array[2*count] of pstring Key-value pairs.

Description

This extension allows renaming OOP command names. The functionality is warranted by the ZZT game Banana Quest, as well as by WeaveZZT 2.0.

A list of key-value pairs is provided; a command using the given key is renamed to the given value.

  • Renaming commands which precede the extension SHOULD work correctly. This is required to support WeaveZZT 2.0-style “renaming of added commands”.
  • Renaming commands which succeed the extension is undefined behaviour.
  • Renaming commands which do not exist SHOULD produce a loading error.
  • The extension MAY be used multiple times. In particular, the extension MAY be used as a conflict resolution measure: given two competing implementations of the same new command, the extension MAY be used to rename one of them before adding the second new command. (However, implementations which do not support this may produce a loading error.)

Implementations

TBD

zxt/extension/0000a51e/0006.txt · Last modified: 2021/12/27 08:45 by asie