mirror of
https://github.com/TwilitRealm/dusklight
synced 2026-08-12 19:24:55 -04:00
TakaRikka
95 lines
3.5 KiB
C
95 lines
3.5 KiB
C
#pragma once
|
|
|
|
#include <mods/api.h>
|
|
|
|
#ifdef __cplusplus
|
|
#include <mods/service.hpp>
|
|
#endif
|
|
|
|
#define ITEM_SERVICE_ID "dev.twilitrealm.dusklight.item"
|
|
#define ITEM_SERVICE_MAJOR 2u
|
|
#define ITEM_SERVICE_MINOR 0u
|
|
|
|
/* 0 is never a valid handle. */
|
|
typedef uint64_t ItemCheckHandle;
|
|
typedef uint64_t ItemGiveHandle;
|
|
|
|
/*
|
|
* Item check resolution and inventory grants.
|
|
*
|
|
* Check names are case-sensitive. Resolvers must be free of side effects because the game may
|
|
* resolve a check more than once, including once for display and again when granting the item.
|
|
* Registrations and pending grants are removed when the calling mod is detached. Callbacks run
|
|
* on the game thread.
|
|
*/
|
|
|
|
/* Host-owned callback data, valid only for the duration of the callback. */
|
|
typedef struct ItemCheckInfo {
|
|
const char* name;
|
|
const void* giver_actor; /* fopAc_ac_c*, or NULL when unavailable */
|
|
uint8_t vanilla_item;
|
|
uint8_t current_item;
|
|
} ItemCheckInfo;
|
|
|
|
/* Return true and write out_item to replace current_item, or false to leave it unchanged. */
|
|
typedef bool (*ItemCheckResolveFn)(
|
|
ModContext* ctx, const ItemCheckInfo* info, uint8_t* out_item, void* user_data);
|
|
|
|
typedef enum ItemGiveOrigin {
|
|
ITEM_GIVE_ORIGIN_GAME = 0,
|
|
ITEM_GIVE_ORIGIN_QUEUE = 1,
|
|
ITEM_GIVE_ORIGIN_QUEUE_SILENT = 2,
|
|
} ItemGiveOrigin;
|
|
|
|
/* Host-owned callback data, valid only for the duration of the callback. */
|
|
typedef struct ItemGiveInfo {
|
|
const char* check_name; /* NULL when the grant is not attributed to a check */
|
|
const void* giver_actor; /* fopAc_ac_c*, or NULL when unavailable */
|
|
uint8_t item;
|
|
uint8_t origin; /* ItemGiveOrigin */
|
|
} ItemGiveInfo;
|
|
|
|
typedef void (*ItemGiveObserveFn)(ModContext* ctx, const ItemGiveInfo* info, void* user_data);
|
|
|
|
enum {
|
|
/* Apply the inventory change without a get-item demo. */
|
|
ITEM_GIVE_SILENT = 1u << 0,
|
|
/* Resolve item_no as the named check's vanilla item when the queue entry is dispatched. */
|
|
ITEM_GIVE_RESOLVE = 1u << 1,
|
|
};
|
|
|
|
typedef struct ItemService {
|
|
ServiceHeader header;
|
|
|
|
/* Set or replace the calling mod's fixed override for name. */
|
|
ModResult (*set_check_override)(ModContext* ctx, const char* name, uint8_t item_no);
|
|
|
|
ModResult (*clear_check_override)(ModContext* ctx, const char* name);
|
|
|
|
/* Register for name, or for every check when name is NULL. out_handle may be NULL. */
|
|
ModResult (*set_check_resolver)(ModContext* ctx, const char* name, ItemCheckResolveFn fn,
|
|
void* user_data, ItemCheckHandle* out_handle);
|
|
|
|
ModResult (*clear_check_resolver)(ModContext* ctx, ItemCheckHandle handle);
|
|
|
|
/* Resolve without granting an item or notifying give observers. */
|
|
ModResult (*resolve_check)(
|
|
ModContext* ctx, const char* name, uint8_t vanilla_item, uint8_t* out_item);
|
|
|
|
/*
|
|
* Add a grant to the global FIFO. check_name may be NULL unless ITEM_GIVE_RESOLVE is set.
|
|
* Returns MOD_UNAVAILABLE when the queue is full. Entries wait until gameplay is in a safe
|
|
* state and are cleared when the active save slot changes.
|
|
*/
|
|
ModResult (*give_item)(
|
|
ModContext* ctx, const char* check_name, uint8_t item_no, uint32_t flags);
|
|
|
|
/* Observe inventory grants. out_handle may be NULL. */
|
|
ModResult (*observe_gives)(
|
|
ModContext* ctx, ItemGiveObserveFn fn, void* user_data, ItemGiveHandle* out_handle);
|
|
|
|
ModResult (*unobserve_gives)(ModContext* ctx, ItemGiveHandle handle);
|
|
} ItemService;
|
|
|
|
MOD_DECLARE_SERVICE(ItemService, svc_item, ITEM_SERVICE_ID, ITEM_SERVICE_MAJOR, ITEM_SERVICE_MINOR);
|