6.9 KiB
PORT VIP card
A card extends all seven original premium services of the account. 40250 has the services but no in-game way to grant them. Source: src/server/game/src/port_premium.h, the hook in CHARACTER::UseItem (char_item.cpp), the enter-game refresh in input_login.cpp, CHARACTER::PortSetPremiumTime (char.h) and /mt_vip (cmd_general.cpp, cmd.cpp). Item data (size, flags, names, shop): metin2-client tools/server/vip-card.
Services
account.account holds one end time per service. The game keeps them in m_aiPremiumTimes and shows affect AFFECT_PREMIUM_START + i (500..506) as the icon.
| i | Premium | Column | Effect on newcibn |
|---|---|---|---|
| 0 | PREMIUM_EXP |
silver_expire |
monster exp ×1.2 × mob_exp_buyer/100 (char_battle.cpp) |
| 1 | PREMIUM_ITEM |
gold_expire |
item drop rate |
| 2 | PREMIUM_SAFEBOX |
safebox_expire |
safebox size 3 (input_db.cpp) |
| 3 | PREMIUM_AUTOLOOT |
autoloot_expire |
gold goes straight to the bag (char_battle.cpp) |
| 4 | PREMIUM_FISH_MIND |
fish_mind_expire |
fishing |
| 5 | PREMIUM_MARRIAGE_FAST |
marriage_fast_expire |
marriage love points |
| 6 | PREMIUM_GOLD |
money_drop_rate_expire |
gold drop rate |
Cards
| Vnum | Days |
|---|---|
| 38001 | 7 |
| 38002 | 30 |
Both are unused ITEM_NONE rows in 40250. PortVipUseCard runs in UseItem after the sex check, before any type handling, so the item type does not matter.
When a card is used:
- The card is refused, and not consumed, in two cases:
- the player used a card or
/mt_vipless than 1 s ago (rate); - for any service, the remaining time plus the card would exceed 400 days (
full). Theintend times stay far below 2038.
- the player used a card or
- Otherwise one card is consumed, with an
MT_VIP_CARDitem log whose hint is the number of days. - One
UPDATEmoves every column toGREATEST(UNIX_TIMESTAMP(col), UNIX_TIMESTAMP()) + days × 86400. A service that has expired restarts from now; a running one is extended.
Freshness
Auth reads the columns only at login and passes them to the db core's CLoginData. Every later player load, such as a warp or a core change, fills TPlayerTable.aiPremiumTimes from that login-time copy. So after a card, and on every enter-game, the game reads the row itself.
PortVipRefresh handles this:
- It queues
SELECT UNIX_TIMESTAMP(col)... FROM account.account WHERE id=throughDBManager::FuncQuery. That is the same ordered queue and connection as the card'sUPDATE, so the read sees the update. - The answer finds the player again by PID and checks the account ID; if the player has left, nothing happens.
- For each service whose end changed, it sets
m_aiPremiumTimes[i], then either adds the affect with the remaining duration or removes it if the service has expired. - It logs
PORT_VIP: <name> type <i> end <unix>.
The db core is not changed.
Protocol
/mt_vip 1 status ask for the remaining time
MTVIP1 times R0 R1 R2 R3 R4 R5 R6 remaining seconds per service (0 = none), PREMIUM_EXP .. PREMIUM_GOLD
MTVIP1 added VNUM DAYS a card was consumed; a times line follows once the row is read back
MTVIP1 error CODE rate full invalid
statusand card use share the 1 s throttle per player.- A wrong version, or more than three tokens, gets no answer; an old client never sends one.
- The client (metin2-client
src/platform/ScriptLib/VipScript.inc, modulemt_vip) treats astatuswith no answer within 3 s as a server without the feature.
Exp bonus
On newcibn the premium exp branch multiplies by 1.2 and then by GetMobExpRate, which returns event flag mob_exp_buyer (default 100). /e mob_exp_buyer 167 gives 1.2 × 1.67 ≈ 2.0, that is +100 %. Event flags live in player.quest (pid 0) and every core shares them, so the flag is set once, by a GM, at deploy.
Verification
tests/features/test_vip.pychecks the wiring:- the command entry is at the end of
cmd_info; - the include is outside the
__AUCTION__block; - the hook sits between the sex check and the summon-item block;
- the refresh runs after the login affect loop.
- the command entry is at the end of
- It also compiles the production header against a stub account table, the ordered SQL queue and the affects. It covers:
- a 7-day card, the read-back and the icons;
- the gap refusal, then a 30-day card stacked onto the current end;
- the 400-day cap: no card consumed, no query;
- other items left untouched;
- the enter-game refresh over stale values;
- a service expired by hand, and the
statuscommand; - a player who leaves before the answer, and a missing account row.
- Live test, channel5 (2026-10-15), Admin account with all expire values reset to 0:
- 38002 (30 days) set all seven columns to now + 30 days, added affects 500..506 and returned
times 2592000…. - Two 38001 used through the inventory right-click, 2 s apart, extended to 44 days.
- A same-map
/warpreloaded the player with the login-time 30 days. The refresh logged the sevenPORT_VIPcorrections to 44 days, and the panel showed "剩余 43 天 23 小时" for every service. - Earlier, with premium, autoloot gold went straight to the bag; without it, the gold stayed on the ground.
- 38002 (30 days) set all seven columns to now + 30 days, added affects 500..506 and returned
Production deployment
- Deployed 2026-10-16 (server clock 2026-10-15 20:44) with the user's approval, 0 players online. Server main
69e335b, which includes the/mcommand-prefix fix3590a06. Game sha2568d0bf9f0…(the channel-5 tested binary); db unchanged.- Package:
/root/deploy-features/20261016-vip(metin2-clienttools/serverat main 32372c2a). - Binary backup:
/root/backup-bin/20261015-204352. - Rollback:
sh /root/deploy-features/20261016-vip/deploy.sh rollback. The data backups are in/root/backup-vip-card/20261015-204353and/root/backup-npcshop/item_mall-20261015-204353. /usr/metin2/srcwas synced with the six changed files.
- Package:
deploy.sh gostops every core, then installs the game. It runsvip-card/install.shand the item-mall shop install while the db core is down, since db readsitem_proto.txtat boot. Then it starts db alone, waits for port 15000, and starts auth, CH1–CH4, game99 and channel5: 14 game, 1 db, 1 auth.- At boot the db core rewrites
player.item_protofrom the txt, withlocale_nameNonamefor every item; names come fromitem_names.txt. Both cards: size 1, flag 8196, antiflag 256. /e mob_exp_buyer 167was set from CH1. Every core loggedQUEST eventflag mob_exp_buyer 167, and the row is inplayer.quest(pid 0).- CH1 (13000) acceptance:
/m 101spawned and/purgeremoved it.- 9010 (map a1) lists 38001/38002. A buyer from another empire pays the original triple price (shop.cpp), 15 000 000 for a 7-day card.
- Two 38001 bought: each takes one cell (a shop buy never merges), and dragging one onto the other gives a stack of 2.
- Using one:
added 38001 7, thentimes 4400055…. The panel shows 50 days 22 hours for all seven services. - syserr only has the pre-existing
new_quest_lv52LUA_ERROR.