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

服务端（Go）： - GM 塞背包/带属性装备发放：在线角色推送 op14 增量物品行，背包实时刷新，无需回角色选择界面 - GM 改金币/改等级：去掉在线拒绝，落库后推送 op14 钱包/op37 等级状态，在线实时刷新 - 等级端点统一切换到新版 GMSetCharacterLevel（自带在线刷新） - 无限/锁死疲劳模式 + 燃烧疲劳：每房间消耗 2 点、打怪与通关经验双倍 - 燃烧疲劳开关时给所有在线角色推送系统提示（op12 mode 0） - 深渊史诗掉率：GM 全局倍率 + 城镇增益药剂窗口倍率，真实接入掉落结算启动器（Python/JS）： - 标题栏自绘、窗口 1204x717、禁止拖拽改大小、仅最小化/关闭 - GM 工具：疲劳与燃烧、深渊史诗掉率、拍卖行上架（单一定价对齐） - 拍卖行上架前端对齐服务端单一价格语义，修复 400 报错
2026-11-04 14:31:55 +08:00
commit 645b64fe21
@@ -0,0 +1,202 @@
+package dnfbridge
+
+import (
+	"errors"
+	"fmt"
+
+	"longheng.io/server/internal/modules/dnf/dungeoncmd"
+	"longheng.io/server/internal/modules/dnf/worldmap"
+)
+
+var (
+	errDungeonEntryModeUnsupported   = errors.New("dnf dungeon entry mode is not supported by the current packet owner")
+	errDungeonBossCoordinateRequired = errors.New("dnf dungeon boss coordinate is required")
+	errDungeonBossCoordinateRange    = errors.New("dnf dungeon boss coordinate exceeds current EXE range")
+	errDungeonMazeIndexRange         = errors.New("dnf dungeon maze index exceeds current EXE range")
+	errDungeonRandomizedObjectOwner  = errors.New("dnf dungeon randomized object owner is required")
+)
+
+const (
+	currentDungeonInfoNotification  uint16 = 28
+	currentDungeonStartNotification uint16 = 29
+)
+
+type currentDungeonEntryPackets struct {
+	DungeonInfo             []byte
+	RandomizedCreatureQueue []byte
+	RandomizedCreatureCount int
+	StartMap                []byte
+}
+
+func buildCurrentDungeonEntryPackets(
+	runtime *runtimeDungeonState,
+	scene worldmap.DungeonRoomScene,
+) (currentDungeonEntryPackets, error) {
+	return buildCurrentDungeonEntryPacketsWithPassiveDrops(runtime, scene, nil)
+}
+
+func buildCurrentDungeonEntryPacketsWithPassiveDrops(
+	runtime *runtimeDungeonState,
+	scene worldmap.DungeonRoomScene,
+	extraEntries []currentDungeonStartMapExtraEntry,
+) (currentDungeonEntryPackets, error) {
+	if runtime == nil || runtime.Room == nil || runtime.Session == nil {
+		return currentDungeonEntryPackets{}, errDungeonWorldMapUnavailable
+	}
+	if err := validateCurrentDungeonEntryRequest(runtime.Request); err != nil {
+		return currentDungeonEntryPackets{}, err
+	}
+	if runtime.Dungeon.ID <= 0 || runtime.Dungeon.ID > int64(^uint32(0)) {
+		return currentDungeonEntryPackets{}, fmt.Errorf("%w: dungeon=%d", errDungeonStartMapMapIDRange, runtime.Dungeon.ID)
+	}
+	if runtime.MazeIndex < 0 || runtime.MazeIndex > int(^uint8(0)) {
+		return currentDungeonEntryPackets{}, fmt.Errorf("%w: maze=%d", errDungeonMazeIndexRange, runtime.MazeIndex)
+	}
+	if !runtime.BossSet {
+		return currentDungeonEntryPackets{}, errDungeonBossCoordinateRequired
+	}
+	if runtime.BossCoordinate.X < 0 || runtime.BossCoordinate.X > 0xff || runtime.BossCoordinate.Y < 0 || runtime.BossCoordinate.Y > 0xff {
+		return currentDungeonEntryPackets{}, fmt.Errorf("%w: boss=%s", errDungeonBossCoordinateRange, runtime.BossCoordinate)
+	}
+	if runtime.MazeIndex >= len(runtime.Dungeon.Mazes) {
+		return currentDungeonEntryPackets{}, fmt.Errorf("%w: maze=%d count=%d", worldmap.ErrMazeNotFound, runtime.MazeIndex, len(runtime.Dungeon.Mazes))
+	}
+	if currentDungeonExplicitHellPartyRequest(runtime.Request, runtime.Dungeon, runtime.MazeIndex) && runtime.HellParty == nil {
+		return currentDungeonEntryPackets{}, errDungeonEntryModeUnsupported
+	}
+	if count := len(runtime.Dungeon.Mazes[runtime.MazeIndex].RandomizedObjects); count != 0 && !runtime.RandomizedObjectsPlanned {
+		return currentDungeonEntryPackets{}, fmt.Errorf("%w: count=%d", errDungeonRandomizedObjectOwner, count)
+	}
+	if runtime.HellParty != nil {
+		if runtime.HellParty.Room.Coordinate.X < 0 || runtime.HellParty.Room.Coordinate.X > 0xff || runtime.HellParty.Room.Coordinate.Y < 0 || runtime.HellParty.Room.Coordinate.Y > 0xff {
+			return currentDungeonEntryPackets{}, fmt.Errorf("%w: hell_room=%s", errDungeonBossCoordinateRange, runtime.HellParty.Room.Coordinate)
+		}
+	}
+	// Map [special passive object] child rows such as [item], [trap], [quest],
+	// and [hellparty] are script metadata owned by the type-9 passive object.
+	// The current op29 reader has no actor row for those child kinds: only the
+	// passive object itself and [monster] children belong to Actors. ExtraEntries
+	// are a different table of materialized item drops and must not be invented
+	// from these metadata rows. Keep the retained rows in the room runtime for
+	// their later feature owners, but do not block the typed op28/op29 entry.
+
+	// These values are protocol sentinels, not map fallbacks. The current EXE
+	// branches on packetSeed == UINT32_MAX to skip the absent hell-party state.
+	// Single Anton's 210-224 selector IDs belong only to the raid directory and
+	// resource projection. Once the client enters a dungeon, op28 must carry the
+	// dedicated 5314-5322 PVF identity. The EXE selects its room topology from
+	// this field; projecting 5322 back to ordinary Anton 218 makes it request the
+	// normal raid's 1:1 room even though the single-player maze continues 1:0 ->
+	// 0:0.
+	infoPacket := currentDungeonInfo{
+		DungeonID:      uint32(runtime.Dungeon.ID),
+		Difficulty:     runtime.Request.Difficulty,
+		EntryOption:    runtime.Request.EntryOption,
+		MazeIndex:      byte(runtime.MazeIndex),
+		BossX:          byte(runtime.BossCoordinate.X),
+		BossY:          byte(runtime.BossCoordinate.Y),
+		HellPartyRoomX: 0xff,
+		HellPartyRoomY: 0xff,
+		DungeonMode:    byte(runtime.ProtocolMode),
+		PairGroups:     currentDungeonRandomizedObjectInfoGroups(runtime.RandomizedObjectSelections),
+		DungeonValue:   12,
+		PacketSeed:     ^uint32(0),
+	}
+	if runtime.HellParty != nil {
+		infoPacket.HellPartyRoomX = byte(runtime.HellParty.Room.Coordinate.X)
+		infoPacket.HellPartyRoomY = byte(runtime.HellParty.Room.Coordinate.Y)
+		infoPacket.HellPartyValue = 1
+		infoPacket.Value2 = 0x0b
+	}
+	dungeonInfoBody, err := infoPacket.Build()
+	if err != nil {
+		return currentDungeonEntryPackets{}, fmt.Errorf("build current dungeon-info body: %w", err)
+	}
+	partyMemberIndex := byte(0xff)
+	// The same-version party START_MAP reader treats 0xff as the all-member
+	// binding branch. A concrete slot is mutually exclusive and leaves every
+	// other stable actor outside the room on that receiving connection.
+	if runtime.partyDungeonOwner == nil && runtime.partyMemberIndexed {
+		partyMemberIndex = runtime.partyMemberIndex
+	}
+	startState := currentDungeonStartMapState{
+		Seed:             runtime.Seed,
+		RoomStateValue:   1,
+		RoomStateFlag:    currentDungeonStartMapPayloadBuild,
+		ExtraEntries:     extraEntries,
+		RidableGroups:    currentDungeonRidableGroupsForRoom(runtime.RandomizedObjectGroups, scene.Coordinate),
+		PartyMemberIndex: partyMemberIndex,
+	}
+	if runtime.HellParty != nil {
+		startState.HellPartyMode = runtime.HellParty.Mode
+		startState.HellPartyFogFlag = 1
+	}
+	var startMapBody []byte
+	if runtime.altar != nil {
+		startMapBody, err = buildCurrentDungeonAltarStartMapBody(scene, runtime.Seed, false)
+		if err != nil {
+			return currentDungeonEntryPackets{}, fmt.Errorf("build current altar start-map body: %w", err)
+		}
+	} else {
+		startPacket, planErr := currentDungeonStartMapFromRuntime(runtime, scene, startState)
+		if planErr != nil {
+			return currentDungeonEntryPackets{}, fmt.Errorf("plan current start-map body: %w", planErr)
+		}
+		startMapBody, err = startPacket.Build()
+		if err != nil {
+			return currentDungeonEntryPackets{}, fmt.Errorf("build current start-map body: %w", err)
+		}
+	}
+	randomizedCreatureQueue, randomizedCreatureCount, err := buildCurrentDungeonRandomizedCreatureQueue(
+		scene.Coordinate,
+		runtime.RandomizedObjectSelections,
+	)
+	if err != nil {
+		return currentDungeonEntryPackets{}, fmt.Errorf("build current randomized creature queue: %w", err)
+	}
+	return currentDungeonEntryPackets{
+		DungeonInfo:             dungeonInfoBody,
+		RandomizedCreatureQueue: randomizedCreatureQueue,
+		RandomizedCreatureCount: randomizedCreatureCount,
+		StartMap:                startMapBody,
+	}, nil
+}
+
+func currentDungeonClientID(runtime *runtimeDungeonState) int64 {
+	if runtime == nil {
+		return 0
+	}
+	if runtime.clientDungeonID > 0 {
+		return runtime.clientDungeonID
+	}
+	return runtime.Dungeon.ID
+}
+
+func validateCurrentDungeonEntryRequest(request dungeoncmd.SelectDungeonRequest) error {
+	// The current fixed 21-byte writer has now been observed sending a nonzero
+	// u32 at offset 16 in an otherwise ordinary solo request. That value is not
+	// consumed by either typed op28 or op29 builder, and its current semantics
+	// are not proved. Preserve it in the runtime request, but do not reject the
+	// normal entry mode or infer leader/quest authority from it.
+	if currentDungeonHellPartyRequest(request) {
+		return nil
+	}
+	_, runtimeStateSupported := currentDungeonProtocolModeForWire(request.RuntimeState, request.RuntimeToken)
+	if request.EntryOption != 0 || request.SelectionMode != 0 || !runtimeStateSupported ||
+		(request.RuntimeToken != 0 && request.RuntimeToken != 0xffff) || request.Reserved != 0 || request.PartyState != 0 ||
+		request.SpecialMode != 0 || len(request.OpaqueTail) != 0 {
+		return fmt.Errorf("%w: entry_option=%d selection_mode=%d runtime_state=%d runtime_token=%d reserved=%d party_state=%d offset16_unproven=%d special_mode=%d opaque_tail=%d",
+			errDungeonEntryModeUnsupported,
+			request.EntryOption,
+			request.SelectionMode,
+			request.RuntimeState,
+			request.RuntimeToken,
+			request.Reserved,
+			request.PartyState,
+			request.LeaderObjectKey,
+			request.SpecialMode,
+			len(request.OpaqueTail),
+		)
+	}
+	return nil
+}