mirror of
https://github.com/Mezeporta/Erupe.git
synced 2026-03-22 07:32:32 +01:00
d578e68b79
The G1-GG gacha code path (PR #150) included example data in comments that used non-zero item_type/item_number/item_quantity on entry_type=100 rows. Users copying these values for ZZ servers caused client crashes because the ZZ client interprets those fields as material requirements. - Replace unclear PR #150 comment with explicit WARNING against using G1-GG example values for ZZ servers - Add gacha configuration guide header to GachaDemo.sql explaining the 3-table system, entry types, and item type codes - Add Mega Potion example showing correct way to add custom items - Reference Enumerations.md for the full item type list
137 lines
9.0 KiB
PL/PgSQL
137 lines
9.0 KiB
PL/PgSQL
BEGIN;
|
||
|
||
-- =============================================================================
|
||
-- Gacha Configuration Guide (G10+ / ZZ clients)
|
||
-- =============================================================================
|
||
--
|
||
-- Gacha uses THREE tables:
|
||
-- gacha_shop — defines the gacha lottery (name, banners, type)
|
||
-- gacha_entries — defines roll costs (entry_type 0/1/...) and reward pool (entry_type 100)
|
||
-- gacha_items — defines the actual items awarded for each reward entry
|
||
--
|
||
-- Entry types:
|
||
-- 0, 1, 2, ... = Roll cost tiers. item_type/item_number/item_quantity define the currency
|
||
-- and amount to deduct. "rolls" = how many random draws this tier gives.
|
||
-- 100 = Reward pool entry. The client draws from these when rolling.
|
||
-- For G10+/ZZ: item_type, item_number, item_quantity MUST be 0.
|
||
-- The actual reward items are defined in gacha_items (linked by entry ID).
|
||
-- "weight" controls draw probability; "rarity" sets the display star rating.
|
||
--
|
||
-- Item types in gacha_items (see Enumerations.md for the full list):
|
||
-- 0 = Legs, 1 = Head, 2 = Chest, 3 = Arms, 4 = Waist,
|
||
-- 5 = Melee weapon, 6 = Ranged weapon, 7 = Consumable item,
|
||
-- 8 = Furniture, 10 = Zenny, 17 = N Points, 19 = Gacha Koban, ...
|
||
--
|
||
-- WARNING: For G1–GG clients, gacha works differently — rewards are defined
|
||
-- directly in gacha_entries and gacha_items is NOT used. Do not mix the two
|
||
-- formats. See handlers_shop.go for the G1–GG code path.
|
||
-- =============================================================================
|
||
|
||
-- Start Normal Demo
|
||
INSERT INTO gacha_shop (min_gr, min_hr, name, url_banner, url_feature, url_thumbnail, wide, recommended, gacha_type, hidden)
|
||
VALUES (0, 0, 'Normal Demo',
|
||
'http://img4.imagetitan.com/img4/QeRWNAviFD8UoTx/26/26_template_innerbanner.png',
|
||
'http://img4.imagetitan.com/img4/QeRWNAviFD8UoTx/26/26_template_feature.png',
|
||
'http://img4.imagetitan.com/img4/small/26/26_template_outerbanner.png',
|
||
false, false, 0, false);
|
||
|
||
-- Create two different 'rolls', the first rolls once for 1z, the second rolls eleven times for 10z
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES
|
||
((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 0, 10, 1, 0, 0, 0, 1, 0, 0),
|
||
((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 1, 10, 10, 0, 0, 0, 11, 0, 0);
|
||
|
||
-- Creates a prize of 1z with a weighted chance of 100
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 100, 0, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 1, 0);
|
||
|
||
-- Creates a prize of 2z with a weighted chance of 70
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 70, 1, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 2, 0);
|
||
|
||
-- Creates a prize of 3z with a weighted chance of 10
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 10, 2, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 3, 0);
|
||
|
||
-- Example: adding a consumable item (Mega Potion, item_id=8) as a gacha reward.
|
||
-- Note: for entry_type=100, item_type/item_number/item_quantity in gacha_entries
|
||
-- MUST remain 0 for G10+/ZZ clients. The reward is defined only in gacha_items.
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 50, 1, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 7, 8, 1);
|
||
-- End Normal Demo
|
||
|
||
-- Start Step-Up Demo
|
||
INSERT INTO gacha_shop (min_gr, min_hr, name, url_banner, url_feature, url_thumbnail, wide, recommended, gacha_type, hidden)
|
||
VALUES (0, 0, 'Step-Up Demo', '', '', '', false, false, 1, false);
|
||
|
||
-- Create two 'steps', the first costs 1z, the second costs 2z
|
||
-- The first step has zero rolls so it will only give the prizes directly linked to the entry ID, being 1z
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 0, 10, 1, 0, 0, 0, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 1, 0);
|
||
|
||
-- The second step has one roll on the random prize list as will as the direct prize, being 3z
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 1, 10, 2, 0, 0, 0, 1, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 3, 0);
|
||
|
||
-- Set up two random prizes, the first gives 1z, the second gives 2z
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 100, 0, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 1, 0);
|
||
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 90, 1, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 2, 0);
|
||
-- End Step-Up Demo
|
||
|
||
-- Start Box Demo
|
||
INSERT INTO gacha_shop (min_gr, min_hr, name, url_banner, url_feature, url_thumbnail, wide, recommended, gacha_type, hidden)
|
||
VALUES (0, 0, 'Box Demo', '', '', '', false, false, 4, false);
|
||
|
||
-- Create two different 'rolls', the first rolls once for 1z, the second rolls twice for 2z
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES
|
||
((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 0, 10, 1, 0, 0, 0, 1, 0, 0),
|
||
((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 1, 10, 2, 0, 0, 0, 2, 0, 0);
|
||
|
||
-- Create five different 'Box' items, weight is always 0 for these
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 0, 0, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 1, 0);
|
||
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 0, 0, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 1, 0);
|
||
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 0, 0, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 1, 0);
|
||
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 0, 0, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 2, 0);
|
||
|
||
INSERT INTO gacha_entries (gacha_id, entry_type, item_type, item_number, item_quantity, weight, rarity, rolls, daily_limit, frontier_points)
|
||
VALUES ((SELECT id FROM gacha_shop ORDER BY id DESC LIMIT 1), 100, 0, 0, 0, 0, 0, 0, 0, 0);
|
||
INSERT INTO gacha_items (entry_id, item_type, item_id, quantity)
|
||
VALUES ((SELECT id FROM gacha_entries ORDER BY id DESC LIMIT 1), 10, 3, 0);
|
||
-- End Box Demo
|
||
|
||
END; |