mirror of
https://github.com/Bubberstation/Bubberstation.git
synced 2025-12-10 01:34:01 +00:00
d1cfb4338e
* Contextual screentips -- Screentips now show you what items/objects can do (#64502) Adds the foundational system for contextual screentips, which will show you what you can do with objects/items, including through context, such as what you are holding. Provides several helper elements for most use cases, and applies it to a handful of common objects in order to show the full breadth of the system. Changes screentips preference from on/off to on/off/only with context. Players who originally had it on off will have it migrated to only with context, though can re-disable it. * Contextual screentips -- Screentips now show you what items/objects can do Co-authored-by: Mothblocks <35135081+Mothblocks@users.noreply.github.com>
24 lines
1.7 KiB
Plaintext
24 lines
1.7 KiB
Plaintext
/// A "Type-A" contextual screentip interaction.
|
|
/// These are used for items that are defined by their behavior. They define their contextual text within *themselves*,
|
|
/// not in their targets.
|
|
/// Examples include syringes (LMB to inject, RMB to draw) and health analyzers (LMB to scan health/wounds, RMB for chems)
|
|
/// Items can override `add_item_context()`, and call `register_item_context()` in order to easily connect to this.
|
|
/// Called on /obj/item with a mutable screentip context list, the hovered target, and the mob hovering.
|
|
/// A screentip context list is a list that has context keys (SCREENTIP_CONTEXT_*, from __DEFINES/screentips.dm)
|
|
/// that map to the action as text.
|
|
/// If you mutate the list in this signal, you must return CONTEXTUAL_SCREENTIP_SET.
|
|
#define COMSIG_ITEM_REQUESTING_CONTEXT_FOR_TARGET "item_requesting_context_for_target"
|
|
|
|
/// A "Type-B" contextual screentip interaction.
|
|
/// These are atoms that are defined by what happens *to* them. These should define contextual text within themselves, and
|
|
/// not in their operating tools.
|
|
/// Examples include construction objects (LMB with glass to put in screen for computers).
|
|
/// Called on /atom with a mutable screentip context list, the item being used, and the mob hovering.
|
|
/// A screentip context list is a list that has context keys (SCREENTIP_CONTEXT_*, from __DEFINES/screentips.dm)
|
|
/// that map to the action as text.
|
|
/// If you mutate the list in this signal, you must return CONTEXTUAL_SCREENTIP_SET.
|
|
#define COMSIG_ATOM_REQUESTING_CONTEXT_FROM_ITEM "atom_requesting_context_from_item"
|
|
|
|
/// Tells the contextual screentips system that the list context was mutated.
|
|
#define CONTEXTUAL_SCREENTIP_SET (1 << 0)
|