DNF90 服务端与启动器完整源码(含 GM 工具功能增强)

服务端(Go):
- GM 塞背包/带属性装备发放:在线角色推送 op14 增量物品行,背包实时刷新,无需回角色选择界面
- GM 改金币/改等级:去掉在线拒绝,落库后推送 op14 钱包/op37 等级状态,在线实时刷新
- 等级端点统一切换到新版 GMSetCharacterLevel(自带在线刷新)
- 无限/锁死疲劳模式 + 燃烧疲劳:每房间消耗 2 点、打怪与通关经验双倍
- 燃烧疲劳开关时给所有在线角色推送系统提示(op12 mode 0)
- 深渊史诗掉率:GM 全局倍率 + 城镇增益药剂窗口倍率,真实接入掉落结算

启动器(Python/JS):
- 标题栏自绘、窗口 1204x717、禁止拖拽改大小、仅最小化/关闭
- GM 工具:疲劳与燃烧、深渊史诗掉率、拍卖行上架(单一定价对齐)
- 拍卖行上架前端对齐服务端单一价格语义,修复 400 报错
This commit is contained in:
hanfuit committed 2026-11-04 14:31:55 +08:00
commit 645b64fe21
4388 files changed
+1405457

No files matched your search

@@ -0,0 +1,490 @@
// initial_equipment_test.go 验证 C# 初始装备解析链在 Go 侧的槽位和 raw entry 形态。
package dnfbridge
import (
"context"
"encoding/binary"
"os"
"testing"
"time"
dnfrepo "longheng.io/server/internal/modules/dnf/repository"
platformpvf "longheng.io/server/internal/platform/pvf"
)
type initialEquipmentMemSource map[string]string
func (s initialEquipmentMemSource) ReadText(relativePath string) (string, error) {
value, ok := s[cleanInitialPVFPath(relativePath)]
if !ok {
return "", errInitialEquipmentTestMissing(relativePath)
}
return value, nil
}
type errInitialEquipmentTestMissing string
func (e errInitialEquipmentTestMissing) Error() string { return "missing pvf text: " + string(e) }
func TestParseInitialCharacterEquipmentFromSourceUsesDOVEStarterSlotsAndPVFData(t *testing.T) {
source := initialEquipmentMemSource{
"character/character.lst": "14 `old.chr`\n15 `fighter.chr`\n",
"character/fighter.chr": "[job]\n`[fighter]`\n[basic]\n0\n[create equipment list]\n[weapon] 101\n[coat]` 102\n[pants] 103\n[waist] 104\n[shoes] 105\n[magic stone] 106\n[/create equipment list]\n",
"equipment/equipment.lst": "101 `weapon/spear.equ`\n102 `armor/coat.equ`\n103 `armor/pants.equ`\n104 `armor/waist.equ`\n105 `armor/shoes.equ`\n106 `special/magicstone.equ`\n",
"equipment/weapon/spear.equ": "[durability]\n33\n[equipment type]\n1\n[animation job]\n`[fighter]`\n[layer variation]\n2150 `ft_speara`\n[equipment ani script]\n`equipment/character/fighter.lay`\n[layer variation]\n650 `ft_spearb`\n[equipment ani script]\n`equipment/character/fighter.lay`\n[animation job]\n`[swordman]`\n[layer variation]\n999 `wrong_job`\n",
"equipment/armor/coat.equ": "[durability]\n40\n[equipment type]\n2\n",
"equipment/armor/pants.equ": "[durability]\n41\n[equipment type]\n3\n",
}
entries, err := parseInitialCharacterEquipmentFromSource(source, 15)
if err != nil {
t.Fatalf("parse initial equipment: %v", err)
}
if len(entries) != 3 {
t.Fatalf("entries = %d, want 3: %+v", len(entries), entries)
}
want := []struct {
slot int16
itemID int64
durability uint16
}{
{slot: 11, itemID: 101, durability: 33},
{slot: 13, itemID: 102, durability: 40},
{slot: 15, itemID: 103, durability: 41},
}
for idx, entry := range entries {
if entry.Slot != want[idx].slot || entry.ItemID != want[idx].itemID || entry.Durability != want[idx].durability {
t.Fatalf("entry[%d] = slot %d item %d dur %d, want %+v", idx, entry.Slot, entry.ItemID, entry.Durability, want[idx])
}
raw := entry.RawEntry
if len(raw) != 43 {
t.Fatalf("entry[%d] raw len = %d, want 43", idx, len(raw))
}
if raw[0] != byte(entry.Slot) ||
binary.LittleEndian.Uint32(raw[1:5]) != uint32(entry.ItemID) ||
binary.LittleEndian.Uint32(raw[5:9]) != initialEquipmentCreateValue ||
binary.LittleEndian.Uint16(raw[10:12]) != entry.Durability {
t.Fatalf("entry[%d] raw header = %x", idx, raw[:12])
}
}
if entries[0].EquipType != 1 || entries[1].EquipType != 2 || entries[2].EquipType != 3 {
t.Fatalf("equipment types = %d/%d/%d", entries[0].EquipType, entries[1].EquipType, entries[2].EquipType)
}
if got := entries[0].ModelLayers; len(got) != 2 ||
got[0].Key != 2150 || got[0].Name != "ft_speara" || got[0].Script != "equipment/character/fighter.lay" ||
got[1].Key != 650 || got[1].Name != "ft_spearb" {
t.Fatalf("weapon model layers = %+v", got)
}
if len(entries[1].ModelLayers) != 0 || len(entries[2].ModelLayers) != 0 {
t.Fatalf("non-weapon model layers = %+v / %+v", entries[1].ModelLayers, entries[2].ModelLayers)
}
}
func TestPreloadInitialCharacterEquipmentKeepsJobZero(t *testing.T) {
source := initialEquipmentMemSource{
"character/character.lst": "0 `slayer.chr`\n15 `fighter.chr`\n",
"character/slayer.chr": "[create equipment list]\n[weapon] 201\n[/create equipment list]\n",
"character/fighter.chr": "[create equipment list]\n[coat] 301\n[/create equipment list]\n",
"equipment/equipment.lst": "201 `weapon/slayer.equ`\n301 `armor/fighter.equ`\n",
"equipment/weapon/slayer.equ": "[durability]\n31\n",
"equipment/armor/fighter.equ": "[durability]\n41\n",
}
byJob, err := parseInitialCharacterEquipmentAllFromSource(source)
if err != nil {
t.Fatalf("preload initial equipment: %v", err)
}
if got := len(byJob[0]); got != 1 {
t.Fatalf("job0 entries = %d, want 1", got)
}
if byJob[0][0].ItemID != 201 || byJob[0][0].Durability != 31 {
t.Fatalf("job0 entry = %+v", byJob[0][0])
}
if got := len(byJob[15]); got != 1 {
t.Fatalf("job15 entries = %d, want 1", got)
}
}
func TestRealScriptPVFInitialEquipmentPreload(t *testing.T) {
pvfPath := os.Getenv("DNFBRIDGE_REAL_PVF_SMOKE")
if pvfPath == "" {
t.Skip("set DNFBRIDGE_REAL_PVF_SMOKE to run real Script.pvf preload smoke")
}
archive, err := platformpvf.LoadArchive(platformpvf.Options{Path: pvfPath})
if err != nil {
t.Fatalf("load real pvf: %v", err)
}
byJob, err := parseInitialCharacterEquipmentAllFromSource(archive)
if err != nil {
t.Fatalf("preload real initial equipment: %v", err)
}
if len(byJob) < 16 {
t.Fatalf("real initial equipment jobs = %d, want at least 16", len(byJob))
}
if len(byJob[11]) == 0 {
t.Fatalf("female swordman job 11 initial equipment missing")
}
total := 0
overU16 := 0
for _, entries := range byJob {
for _, entry := range entries {
total++
if entry.ItemID > 0xffff {
overU16++
}
}
}
if total != 48 {
t.Fatalf("real initial equipment total = %d, want 48 (three starter slots for 16 jobs)", total)
}
if overU16 != 16 {
t.Fatalf("real initial equipment ids over u16 = %d, want 16 weapon ids", overU16)
}
if byJob[11][0].ItemID == int64(uint16(byJob[11][0].ItemID)) {
t.Fatalf("female swordman weapon/item id should prove op9 u16 key is not the raw item id: %+v", byJob[11][0])
}
if layers := byJob[11][0].ModelLayers; len(layers) == 0 || layers[0].Key != 2150 || layers[0].Name != "at_katanaa" {
t.Fatalf("female swordman weapon model layers = %+v", layers)
}
if got := byJob[11]; len(got) != 3 || got[0].Slot != 11 || got[1].Slot != 13 || got[2].Slot != 15 {
t.Fatalf("female swordman starter equipment = %+v, want weapon/coat/pants slots 11/13/15", got)
}
}
func TestSaveNewCharacterSeedsInitialEquipmentRecord(t *testing.T) {
repos := testRepositoryGroup()
service := &Service{
initialEquipmentByJob: map[byte][]initialEquipmentEntry{
15: {
{
Slot: 11,
ItemID: 900001,
Durability: 27,
EquipType: 1,
PVFPath: "equipment/weapon/test.equ",
RawEntry: buildInitialEquipmentRawEntry(11, 900001, 27),
ModelLayers: []initialEquipmentModelLayer{
{Key: 2150, Name: "at_katanaa", Script: "equipment/character/atswordman.lay"},
},
},
},
},
}
prepareTestCharacterInitialization(service, 15)
record := dnfrepo.CharacterRecord{
CharacterID: "77",
AccountID: "dnf:1",
Slot: 0,
Name: "hero",
Job: "15",
Level: 1,
Stats: defaultCreatedCharacterStats(0),
CreatedAt: time.Now().UTC(),
UpdatedAt: time.Now().UTC(),
}
if err := service.saveNewCharacter(context.Background(), repos, record); err != nil {
t.Fatalf("save new character: %v", err)
}
equipment, found, err := repos.Equipment.Load(context.Background(), "77")
if err != nil || !found {
t.Fatalf("equipment load found=%t err=%v", found, err)
}
entry, ok := equipment.Entries["11"]
if !ok {
t.Fatalf("equipment slot 11 missing: %+v", equipment.Entries)
}
if entry.ItemID != 900001 || entry.SlotIndex != 11 || binary.LittleEndian.Uint16(entry.RawEntry[10:12]) != 27 {
t.Fatalf("equipment entry = %+v raw=%x", entry, entry.RawEntry)
}
if entry.Extra["source"] != "pvf_create_equipment_list" ||
entry.Extra["max_durability"] != "27" ||
entry.Extra["equipment_type"] != "1" ||
entry.Extra["current_exe_create_value"] != "1" {
t.Fatalf("equipment extra = %+v", entry.Extra)
}
if _, ok := entry.Extra["current_exe_equipment_type"]; ok {
t.Fatalf("PVF equipment type must not be stored as current EXE runtime type: %+v", entry.Extra)
}
if _, ok := entry.Extra["instance_value"]; ok {
t.Fatalf("new PVF seed must not retain the old C# instance field: %+v", entry.Extra)
}
if entry.Extra["model_layer_count"] != "1" ||
entry.Extra["model_layer_0_key"] != "2150" ||
entry.Extra["model_layer_0_name"] != "at_katanaa" ||
entry.Extra["model_layer_0_script"] != "equipment/character/atswordman.lay" {
t.Fatalf("equipment model layer extra = %+v", entry.Extra)
}
}
func TestAttachEquipmentSummaryReplacesStaleRosterFromEquipmentRepository(t *testing.T) {
repos := testRepositoryGroup()
ctx := context.Background()
if err := repos.Equipment.Save(ctx, dnfrepo.EquipmentRecord{
CharacterID: "77",
Entries: map[string]dnfrepo.EquipmentEntry{
"12": {SlotIndex: 12, ItemID: 900012},
},
}); err != nil {
t.Fatalf("save equipment: %v", err)
}
record := dnfrepo.CharacterRecord{
CharacterID: "77",
Job: "15",
Roster: dnfrepo.CharacterRoster{Entry: dnfrepo.CharacterRosterEntry{
EquipSummary: []dnfrepo.CharacterRosterEquipSummary{{Slot: 11, ItemIDOrIcon: 800011}},
}},
}
(&Service{}).attachEquipmentSummary(ctx, repos, &record)
if got := record.Roster.Entry.EquipSummary; len(got) != 1 || got[0].Slot != 12 || got[0].ItemIDOrIcon != 900012 {
t.Fatalf("attached equipment summary = %+v, want repository slot 12 item 900012", got)
}
}
func TestEquipmentRosterSummaryUsesCurrentWeaponAppearancePrecedence(t *testing.T) {
starterWeapon := dnfrepo.EquipmentEntry{
SlotIndex: 11,
ItemID: 1001,
Extra: map[string]string{"source": "pvf_create_equipment_list"},
}
weaponAvatar := dnfrepo.EquipmentEntry{
SlotIndex: 10,
ItemID: 2001,
Extra: map[string]string{
"current_exe_equipment_type": "10",
"current_exe_runtime_move": "1",
},
}
// A +15 starter weapon whose reinforcement packed byte must propagate to
// the selection-card EquipSummary so the golden glow survives.
plusFifteenWeapon := dnfrepo.EquipmentEntry{
SlotIndex: 11,
ItemID: 1234,
Extra: map[string]string{"source": "pvf_create_equipment_list", "reinforce": "15"},
}
tests := []struct {
name string
entries map[string]dnfrepo.EquipmentEntry
want []dnfrepo.CharacterRosterEquipSummary
}{
{
name: "starter weapon is mapped to current weapon appearance slot",
entries: map[string]dnfrepo.EquipmentEntry{"starter": starterWeapon},
want: []dnfrepo.CharacterRosterEquipSummary{{Slot: 12, ItemIDOrIcon: 1001}},
},
{
// The avatar still hides the real weapon visually, but the slot-12
// row is kept so the client can read its reinforcement PackedFlags
// for the glow. Removing the row makes a +15 weapon lose its aura.
name: "weapon avatar keeps real weapon row for reinforcement glow",
entries: map[string]dnfrepo.EquipmentEntry{"starter": starterWeapon, "avatar": weaponAvatar},
want: []dnfrepo.CharacterRosterEquipSummary{
{Slot: 10, ItemIDOrIcon: 2001},
{Slot: 12, ItemIDOrIcon: 1001, PackedFlags: 0},
},
},
{
// Real-world case: a +15 weapon without an avatar must ship the
// packed flags so the selection card shows the gold glow.
name: "plus fifteen starter weapon carries packed flags",
entries: map[string]dnfrepo.EquipmentEntry{"starter": plusFifteenWeapon},
want: []dnfrepo.CharacterRosterEquipSummary{{Slot: 12, ItemIDOrIcon: 1234, PackedFlags: 30}},
},
{
name: "empty equipment keeps only the implicit job weapon",
entries: map[string]dnfrepo.EquipmentEntry{},
want: nil,
},
}
for _, test := range tests {
t.Run(test.name, func(t *testing.T) {
got := equipmentRosterSummary(dnfrepo.EquipmentRecord{CharacterID: "77", Entries: test.entries})
if len(got) != len(test.want) {
t.Fatalf("summary length=%d want=%d summary=%+v", len(got), len(test.want), got)
}
for index := range test.want {
if got[index].Slot != test.want[index].Slot ||
got[index].ItemIDOrIcon != test.want[index].ItemIDOrIcon ||
got[index].PackedFlags != test.want[index].PackedFlags {
t.Fatalf("summary[%d]=%+v want=%+v", index, got[index], test.want[index])
}
}
})
}
}
func TestAttachEquipmentSummaryTreatsExistingEmptyEquipmentAsAuthoritative(t *testing.T) {
repos := testRepositoryGroup()
ctx := context.Background()
if err := repos.Equipment.Save(ctx, dnfrepo.EquipmentRecord{
CharacterID: "77",
Entries: map[string]dnfrepo.EquipmentEntry{},
}); err != nil {
t.Fatalf("save empty equipment: %v", err)
}
record := dnfrepo.CharacterRecord{
CharacterID: "77",
Job: "15",
Roster: dnfrepo.CharacterRoster{Entry: dnfrepo.CharacterRosterEntry{
EquipSummary: []dnfrepo.CharacterRosterEquipSummary{{Slot: 11, ItemIDOrIcon: 800011}},
}},
}
service := &Service{initialEquipmentByJob: map[byte][]initialEquipmentEntry{
15: {{Slot: 11, ItemID: 900011, Durability: 27}},
}}
service.attachEquipmentSummary(ctx, repos, &record)
if got := record.Roster.Entry.EquipSummary; len(got) != 0 {
t.Fatalf("empty equipped set retained stale roster rows: %+v", got)
}
equipment, found, err := repos.Equipment.Load(ctx, "77")
if err != nil || !found {
t.Fatalf("load empty equipment found=%t err=%v", found, err)
}
if len(equipment.Entries) != 0 {
t.Fatalf("empty equipped set was reseeded: %+v", equipment.Entries)
}
}
func TestLegacyCSharpInitialEquipmentValueIsNormalizedOnlyForPVFSeeds(t *testing.T) {
legacyRaw := buildInitialEquipmentRawEntry(11, 900001, 27)
binary.LittleEndian.PutUint32(legacyRaw[5:9], legacyCSharpInitialEquipmentInstanceValue)
seed := dnfrepo.EquipmentEntry{
SlotIndex: 11,
ItemID: 900001,
RawEntry: legacyRaw,
Extra: map[string]string{
"source": "pvf_create_equipment_list",
"instance_value": "999999998",
},
}
if got := currentItemListEquipmentInstance(seed); got != initialEquipmentCreateValue {
t.Fatalf("legacy PVF seed create value = %d, want %d", got, initialEquipmentCreateValue)
}
if got := currentItemListEquipmentValueA(seed); got != 0 {
t.Fatalf("legacy PVF seed valueA = %d, want sparse current default 0", got)
}
normalizedRaw := currentEquipmentRawEntry(seed)
if got := binary.LittleEndian.Uint32(normalizedRaw[5:9]); got != initialEquipmentCreateValue {
t.Fatalf("normalized raw create value = %d, want %d", got, initialEquipmentCreateValue)
}
if got := binary.LittleEndian.Uint32(seed.RawEntry[5:9]); got != legacyCSharpInitialEquipmentInstanceValue {
t.Fatalf("normalization mutated stored input raw = %d", got)
}
nonSeed := seed
nonSeed.Extra = map[string]string{"instance_value": "999999998"}
if got := currentItemListEquipmentInstance(nonSeed); got != legacyCSharpInitialEquipmentInstanceValue {
t.Fatalf("non-seed instance = %d, want preserved %d", got, legacyCSharpInitialEquipmentInstanceValue)
}
if got := currentItemListEquipmentValueA(nonSeed); got != legacyCSharpInitialEquipmentInstanceValue {
t.Fatalf("non-seed valueA = %d, want preserved %d", got, legacyCSharpInitialEquipmentInstanceValue)
}
}
func TestRewriteCurrentSceneObjectTailEquipSummary(t *testing.T) {
tail := append([]byte{1, 2, 3, 4, 5, 6, 1}, make([]byte, currentSceneObjectEquipSummaryRowBytes)...)
tail = append(tail, 0xaa, 0xbb)
rows := []dnfrepo.CharacterRosterEquipSummary{
{Slot: 22, ItemIDOrIcon: 103},
{Slot: 11, ItemIDOrIcon: 101},
}
rewritten, ok := rewriteCurrentSceneObjectTailEquipSummary(tail, rows)
if !ok {
t.Fatalf("rewrite returned false")
}
if rewritten[6] != 2 {
t.Fatalf("summary count = %d, want 2", rewritten[6])
}
if rewritten[7] != 11 || binary.LittleEndian.Uint32(rewritten[8:12]) != 101 {
t.Fatalf("first summary row = %x", rewritten[7:7+currentSceneObjectEquipSummaryRowBytes])
}
if rawLen := binary.LittleEndian.Uint32(rewritten[12:16]); rawLen != 0 {
t.Fatalf("first summary raw len = %d, want 0", rawLen)
}
second := 7 + currentSceneObjectEquipSummaryRowBytes
if rewritten[second] != 22 || binary.LittleEndian.Uint32(rewritten[second+1:second+5]) != 103 {
t.Fatalf("second summary row = %x", rewritten[second:second+currentSceneObjectEquipSummaryRowBytes])
}
if got := rewritten[len(rewritten)-2:]; got[0] != 0xaa || got[1] != 0xbb {
t.Fatalf("tail suffix = %x", got)
}
}
func TestRewriteCurrentSceneObjectTailEquipSummaryKeepsType44RawBlockEmpty(t *testing.T) {
raw := buildInitialEquipmentRawEntry(11, 900001, 27)
tail := append([]byte{1, 2, 3, 4, 5, 6, 0}, 0xaa, 0xbb)
rows := []dnfrepo.CharacterRosterEquipSummary{
{Slot: 11, ItemIDOrIcon: 900001, RawEntry: raw},
}
rewritten, ok := rewriteCurrentSceneObjectTailEquipSummary(tail, rows)
if !ok {
t.Fatalf("rewrite returned false")
}
if rewritten[6] != 1 {
t.Fatalf("summary count = %d, want 1", rewritten[6])
}
row := rewritten[7:]
if row[0] != 11 || binary.LittleEndian.Uint32(row[1:5]) != 900001 {
t.Fatalf("summary row head = %x", row[:5])
}
rawLen := int(binary.LittleEndian.Uint32(row[5:9]))
if rawLen != 0 {
t.Fatalf("summary raw len = %d, want 0", rawLen)
}
suffix := rewritten[7+currentSceneObjectEquipSummaryRowBytes:]
if len(suffix) != 2 || suffix[0] != 0xaa || suffix[1] != 0xbb {
t.Fatalf("tail suffix = %x", suffix)
}
}
func TestCurrentSceneObjectListBodyUsesPVFBackedEquipSummaryRows(t *testing.T) {
name := "hero"
character := dnfrepo.CharacterRecord{
CharacterID: "77",
Name: name,
Job: "11",
Level: 1,
Roster: dnfrepo.CharacterRoster{
Entry: dnfrepo.CharacterRosterEntry{
EquipSummary: []dnfrepo.CharacterRosterEquipSummary{
{Slot: 22, ItemIDOrIcon: 900022, PackedFlags: 3, OptionalIDOrExpire: 44, AuxValue: 55, AuxFlag: 6},
{Slot: 11, ItemIDOrIcon: 900011, PackedFlags: 1, OptionalIDOrExpire: 22, AuxValue: 33, AuxFlag: 2},
},
},
},
}
body := buildCurrentSceneObjectListBody(currentSceneBootstrapObjectKey, character, true, "")
nameLen := len(rosterNameBytes(name))
tailStart := 5 + 0x47 + 2 + 4 + nameLen
if len(body) <= tailStart+7 {
t.Fatalf("scene object body too short len=%d tailStart=%d body=%x", len(body), tailStart, body)
}
tail := body[tailStart:]
if len(tail) <= 6 {
t.Fatalf("mode0 tail too short len=%d tail=%x", len(tail), tail)
}
if tail[6] != 2 {
t.Fatalf("mode0 equipment summary count = %d, want 2", tail[6])
}
first := tail[7 : 7+currentSceneObjectEquipSummaryRowBytes]
if first[0] != 11 || binary.LittleEndian.Uint32(first[1:5]) != 900011 {
t.Fatalf("first mode0 equipment summary row = %x", first)
}
if rawLen := binary.LittleEndian.Uint32(first[5:9]); rawLen != 0 {
t.Fatalf("first mode0 equipment type44 raw len = %d, want 0", rawLen)
}
second := tail[7+currentSceneObjectEquipSummaryRowBytes : 7+2*currentSceneObjectEquipSummaryRowBytes]
if second[0] != 22 || binary.LittleEndian.Uint32(second[1:5]) != 900022 {
t.Fatalf("second mode0 equipment summary row = %x", second)
}
}