Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
api [2020/12/04 16:14] krysune |
api [2021/12/14 04:38] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== API ====== | + | ====== |
| Though great efforts will be made to keep items backwards compatible; it is advised that developers should make scripts easily upgradable to accommodate changes.\\ | Though great efforts will be made to keep items backwards compatible; it is advised that developers should make scripts easily upgradable to accommodate changes.\\ | ||
| ===== Broadcasts ===== | ===== Broadcasts ===== | ||
| Broadcasts are usually handled on five minute intervals; some may occur more frequently and are in the form of JSON objects. It would be prudent to retrieve these values under scripts that have ample free space as broadcast message sizes can increase over time with additional information. | Broadcasts are usually handled on five minute intervals; some may occur more frequently and are in the form of JSON objects. It would be prudent to retrieve these values under scripts that have ample free space as broadcast message sizes can increase over time with additional information. | ||
| + | |||
| ==== Stats ==== | ==== Stats ==== | ||
| Broadcasts internal and external stats as decimal percent values (quantity values may be acquired via the query), and includes additional flags that do not have numeric representation. Some values may exceed 1.000 (100%) such as the physical abdomen attribute which may extend beyond 1.000 depending on what the character may be holding inside, such as a pregnancy for example.\\ | Broadcasts internal and external stats as decimal percent values (quantity values may be acquired via the query), and includes additional flags that do not have numeric representation. Some values may exceed 1.000 (100%) such as the physical abdomen attribute which may extend beyond 1.000 depending on what the character may be holding inside, such as a pregnancy for example.\\ | ||
| + | < | ||
| Channel: -1537921545 | Channel: -1537921545 | ||
| - | { | + | |
| " | " | ||
| " | " | ||
| Line 27: | Line 28: | ||
| } | } | ||
| } | } | ||
| + | </ | ||
| + | ==== State ==== | ||
| - | === State === | ||
| - | Broadcasts the state the HUD is currently in; there have been only 4 different states since inception of the HUD (InitialState, | + | Broadcasts the state the HUD is currently in; there have been only 4 different states since inception of the HUD (InitialState, |
| + | * CopulateState provides the target which is being copulated with and the story (which is the actively selected option such as “Breeding” that may also add additional relevant output).\\ | ||
| + | * Top-level will always have a key that matches the value of “state” (notice in the example state equals “CopulateState” which is the key for the object that holds the target and story entries) | ||
| + | < | ||
| Channel: -1537921546 | Channel: -1537921546 | ||
| { | { | ||
| Line 41: | Line 46: | ||
| } | } | ||
| } | } | ||
| + | </ | ||
| + | ==== Pregnancy ==== | ||
| - | == Pregnancy == | ||
| Broadcasts internals about any pregnancies an individual may have, including how many births of what species from where and about how far along the pregnancy is completed represented as a percent. | Broadcasts internals about any pregnancies an individual may have, including how many births of what species from where and about how far along the pregnancy is completed represented as a percent. | ||
| + | < | ||
| Channel: -1537921547 | Channel: -1537921547 | ||
| { | { | ||
| Line 59: | Line 66: | ||
| } | } | ||
| } | } | ||
| + | </ | ||
| + | === Queries === | ||
| - | == Queries | + | Queries |
| - | Queries may be performed against an individual’s HUD to procure specific information about the current/ | ||
| - | * caution should be exercised in making multiple requests as attempts to abuse this will be met with permanent blocking across all HUDs | + | < |
| - | Channel: | + | Channel: |
| Request: | Request: | ||
| { | { | ||
| Line 75: | Line 83: | ||
| ] | ] | ||
| } | } | ||
| + | </ | ||
| Response: | Response: | ||
| + | < | ||
| { | { | ||
| " | " | ||
| Line 91: | Line 101: | ||
| } | } | ||
| } | } | ||
| + | </ | ||
| + | === Example Scripts: === | ||
| - | == Example Scripts: == | + | **[[https:// |
| + | <WRAP center round tip 60%> | ||
| + | You can copy the system.main script into inventory to reveal the same information. | ||
| + | </ | ||
| - | AnE Stats HUD Script | ||
| - | * can copy the system.main script into inventory to reveal the same information. | ||