Mini Patch 830-2b Changelog - Shifting Sorcery

[Razmataz 14]

	Changelog (Patch 830.2b - "Shifting Sorcery")

---

Release date:  17 July 2021

Here you'll be able to read up on changes, big and small, made to various parts of the server.

Legend
•  White  -  This was not changed. Also used for contrast.
•  Green  -  This was added.
•  Red  -  This was removed.
•  Yellow  -  This was changed.

---

 

Highlights

WMO attribute edits

• You can now change the name, ambience, music and intro sound that plays inside a WMO, both custom spawned & blizzlike versions.

 

Area, Zone, WMO Music Soundkits

• The area, zone and wmo music commands now support specifying soundkits rather than Blizzard's limited ZoneMusic collection.

 

Water, Vertex Shading Shifting

• It is now possible to remove water, or vertex shading from a map (or chunks of the map). Examples of vertex shading is the purple blurs beneath Brill; blackened ground underneath campfires and WMOs; and tinted terrain in Mechagon.

 

---

 

Preamble

WMOId, DoodadSetId & GroupId

• This update introduces the .phase shift wmo manual commandset. These commands require a rather comprehensive understanding of how WMOs work in World of Warcraft. This section aims to provide some brief details about the matter.
   
  • A WMOId is a (typically) unique ID assigned to each WMO displayid. For instance, the Goldshire Inn WMO uses the file "goldshireinn.wmo" and has an arbitrarily assigned WMOId of 53.
     
  • A DoodadSetID or NameID is an ensemble of objects that will only display if the spawned WMO has its DoodadSet set to that ID. So far, this data can only be set in the ADT (and thus is not possible for players to manipulate with their custom spawned WMOs). With the goldshireinn.wmo, there are three DoodadSets associated with it: Deepwater Tavern in Menethil Harbour, Lion's Pride Inn in Goldshire and the unnamed and mostly empty variant when you, the player, spawn it.
     
  • A GroupID is a section of the WMO, which is sometimes used to provide sub-area names while inside the WMO. For example, inside Ironforge you will have the Great Forge, Hall of Explorers, Military Ward, Hall of Mysteries, etc. If you want to affect the whole WMO, you make changes to the GroupID "-1", whereas if you want to affect a small section of it, you will use its GroupId.

 

---

New Commands and Features

.phase

• Subcommands added:
  • .phase shift wmo
    • .phase shift wmo list [$search_string]
      • Lists all WMO overrides that are in effect in your phase. If $search_string is used, only show the area overrides with that edited name.
    • .phase shift wmo list next
      • Displays the next 50 results of the previous command.
         
    • .phase shift wmo root
      • These commands affect the entire blizzard spawned WMO you are in quite like a zone affects an area (Ironforge, Lion's Pride Inn, etc.).
      • .phase shift wmo root name $new_name
        • Replaces the name of the Root WMO you are in with $new_name. If you enclose a colour code between two $ signs, the text following it until the next $ will be coloured (e.g. $81B558$Coloured Text$ will appear as Coloured Text)
      • .phase shift wmo root ambience #ambience_id
        • Replaces the ambience that plays in the Root WMO you are in with #ambience_id.
      • .phase shift wmo root music #music_id [#music_id2]
        • Replaces the music that plays in the Root WMO you are in with #music_id. If #music_id2 is specified then instead creates a new Zone Music entry with #music_id & #music_id2 as sound kits and will play #music_id at day and #music_id2 at night.
      • .phase shift wmo root intro #intro_id
        • Replaces the intro sound that plays in the Root WMO you are in with #intro_id.
      • .phase shift wmo root remove
        • Removes all Root WMO overrides applied to the WMO you are currently in.
           
    • .phase shift wmo sub
      • These commands change the section of the blizzard spawned WMO you are in rather than the whole WMO (Hall of Explorers in Ironforge, Hall of Arms in Ironforge)
      • .phase shift wmo sub name $new_name
        • Replaces the name of the WMO section you are in with $new_name. If you enclose a colour code between two $ signs, the text following it until the next $ will be coloured (e.g. $81B558$Coloured Text$ will appear as Coloured Text)
      • .phase shift wmo sub ambience #ambience_id
        • Replaces the ambience that plays in the WMO section you are in with #ambience_id.
      • .phase shift wmo sub music #music_id [#music_id2]
        • Replaces the music that plays in the WMO section you are in with #music_id. If #music_id2 is specified then instead creates a new Zone Music entry with #music_id & #music_id2 as sound kits and will play #music_id at day and #music_id2 at night.
      • .phase shift wmo sub intro #intro_id
        • Replaces the intro sound that plays in the WMO section you are in with #intro_id.
      • .phase shift wmo sub remove
        • Removes all area overrides applied to the WMO section you are currently in.
           
    • .phase shift wmo manual
      • These commands change the attributes of a WMO found by the three data points you provide it: The WMO Id (interchangable with "RootId"), DoodadSetID and GroupID. WMOs you spawn will rarely have a DoodadSetID that is used by Blizzard WMOs, so this is the only method to change them.
      • .phase shift wmo manual name #WMOId #DoodadSetId #GroupId $new_name
        • Replaces the name of the WMO section you are in with $new_name. If you enclose a colour code between two $ signs, the text following it until the next $ will be coloured (e.g. $81B558$Coloured Text$ will appear as Coloured Text)
      • .phase shift wmo manual ambience #WMOId #DoodadSetId #GroupId #ambience_id
        • Replaces the ambience that plays in the WMO section you specify with #ambience_id.
      • .phase shift wmo manual music #WMOId #DoodadSetId #GroupId #music_id [#music_id2]
        • Replaces the music that plays in the WMO section you specify with #music_id. If #music_id2 is specified then instead creates a new Zone Music entry with #music_id & #music_id2 as sound kits and will play #music_id at day and #music_id2 at night.
      • .phase shift wmo manual intro #WMOId #DoodadSetId #GroupId #intro_id
        • Replaces the intro sound that plays in the WMO section you specify with #intro_id.
      • .phase shift wmo manual remove #WMOId #DoodadSetId #GroupId
        • Removes all area overrides applied to the WMO section you specify.
           
  • .phase shift water
    • .phase shift water adt $on/$off
      • Removes or restores all water on the current ADT.
    • .phase shift water map $on/$off
      • Removes or restores all water on the entire map.
    • .phase shift water reset $CONFIRM
      • Restores all water shifts on the map.
         
  • .phase shift mccv
    • .phase shift mccv adt $on/$off
      • Removes or restores all vertex shading on the current ADT.
    • .phase shift mccv map $on/$off
      • Removes or restores all vertex shading on the entire map.
    • .phase shift mccv reset $CONFIRM
      • Restores all vertex shading shifts on the entire map.

 

.lookup

• Subcommands added:
  • .lookup wmo [$search_string]
    • Lists the WMOId, DoodadSetId and GroupId of all WMOs for use in the phase shift wmo manual commands. If $search_string is used, the list only shows WMOs that match the $search_string in one of three ways:
      • The WMO matches the gameobject name entered in $search_string;
      • the WMO displays the area name text $search_string; or
      • the WMO Subsection displays the area name text $search_string.

 

---

 

Command and Feature Changes

.phase

• .phase shift area music #music_id [#music_id2]
  • The #music_id2 is now supported as an optional parameter. If specified, then it will instead create a new ZoneMusic entry using #music_id and #music_id2 as SoundKits and will play #music_id at day and #music_id2 at night.
• .phase shift zone music #music_id [#music_id2]
  • The #music_id2 is now supported as an optional parameter. If specified, then it will instead create a new ZoneMusic entry using #music_id and #music_id2 as SoundKits and will play #music_id at day and #music_id2 at night.

 

.gps

• GPS will additionally display the WMOId, DoodadSetId and GroupId of the blizzard spawned WMO you are in. This information can be used in .phase shift wmo manual

 

---

 

Bug Fixes

Crashes

• Various efforts have been undertaken to improve server stability and fix causes of crashes.

 

---

 

End of Changelog

 

---

Glossary

Below is a list of common terms you will encounter when reading changelogs and using commands on Epsilon, to help you understand how a command might work.

---

• Syntax
  • The structure of a command, composed of strictly arranged words (arguments and/or parameters) required to be met for the command to be performed.
    • Think of it as the grammar of programming, where all computers are grammar nazis who won't do what you ask if you don't write perfectly.
      • How you see Epsilon's changelog and in-game use of syntax is not what it tends to look like in actual programming.
  • Parameter 
    • Parameters in our case are used to structure the specific command it is you wish to perform.
  • Argument
    • Arguments in our case are used to tell the parameters which data type(s) to use when performing the command.
• Example:
  • Syntax  =  .phase forge npc displays add #display_id %scale %weight
  • In the case of Epsilon, is the same as:
  • Syntax  =  .parameter parameter parameter parameter parameter argument argument argument
    • .phase forge npc displays add 100 2 5
      • The arguments (green) tell the preceding parameters (white) to:
        • "Add"  #display_id  "100"  at %scale  "2"  with %weight  "5"  to the targeted forged NPC.
• Data types
  • Floating Point - Symbol  %
    • A real number, accepts decimals. World of Warcraft does not count more than 6 decimals.
      • .mod scale %scale  =  .mod scale 1.063523
  • Integer - Symbol  #
    • A natural number, does not accept decimals.
      • .gobject spawn #display_id  =  .gobject spawn 175490
  • String - Symbol  $
    • A sequence of characters, typically forming one or multiple words.
      • .summon $name  =  .summon Bob the Builder
• Optional - Symbols  [ ]
  • When a single data type is encased in brackets, it means it's an optional argument and is not required in the syntax for the command to function.
    • .phase forge npc displays add #display_id [%scale] [%weight]
      • #display_id  is required but  [%scale]  and  [%weight]  are optional.
  • When two or more data types are encased in brackets, it means that though they are optional, if one is specified then both are required for the command to function.
    • .gobject teleporter add [#guid] [#icon "$text"] [#x #y #z] [#orientation]
      • No argument is required as the command uses player position by default, however  [#icon "$text"]  requires both arguments to be specified to work.

[Razmataz 14]

Given the complexity of the WMO shift commands, I've thrown together a video running through it: