如何在 MapleStory v83 中实现肩饰槽 (Shoulder Slot)

本教程将指导您如何在 MapleStory v83 服务端中添加肩饰槽。

服务端源码修改

首先，您需要修改服务端源码中的以下 Java 文件。

EquipSlot.java
在定义中添加 SHOULDER 槽位：

    PENDANT("Pe", -17),
    TAMED_MOB("Tm", -18),
    SADDLE("Sd", -19),
    SHOULDER("Sh", -20),
    MEDAL("Me", -49),
    BELT("Be", -50),
    PET_EQUIP;

EquipType.java
添加 SHOULDER 类型及其 ID：

    PET_EQUIP_LABEL(182),
    PET_EQUIP_QUOTE(183),
    RING(111),
    SHOULDER(115),
    SHIELD(109),
    SHOES(107),
    TAMING(190),

ItemInformationProvider.java
更新条件语句以包含肩饰物品 ID 范围 (1152000 到 1153000)：

        } else if ((itemId >= 1010000 && itemId < 1040000) || (itemId >= 1122000 && itemId < 1123000) || (itemId >= 1132000 && itemId < 1133000) || (itemId >= 1142000 && itemId < 1143000)|| (itemId >= 1152000 && itemId < 1153000)) {

客户端修改

现在，将以下 hook 和新文件添加到您的客户端注入器 (injector) 中。

Hook.h
声明 hook 函数并附加它们：

void AttachShoulderSlotsFix();
void AttachIsCorrectBodyPartFix();
void AttachGetBodyPartFromItemFix();
void AttachShoulderDraw(); // 用于视觉修复

inline void AttachClientHooks() {
    AttachShoulderSlotsFix();
    AttachIsCorrectBodyPartFix();
    AttachGetBodyPartFromItemFix();
    AttachShoulderDraw(); // 用于视觉修复
}

stringpool.cpp
替换该槽位所需的字符串：

void AttachStringPoolMod() {
    REPLACE_STRING(3810, "SHOULDER");
}

CMakeLists.txt
将新的 C++ 文件添加到您的注入器编译配置中：

# Build injector
add_library(injector SHARED
    shoulderslots.cpp
    iscorrectbodypart.cpp
    getbodypartfromitem.cpp
    shoulderdraw.cpp
)

接下来，在您的注入器文件夹中创建以下三个新文件：

shoulderslots.cpp
此文件用于修复装备数据路径：

#include "pch.h"
#include "hook.h"

// -----------------------------------------------------------------------------
// 肩饰槽 (Shoulder Slots) / 装备数据路径修复
// -----------------------------------------------------------------------------
// 客户端函数: `get_equip_data_path` @ 0x005C94A1
// 补丁: 将 `cmp eax, 72h` (114) 更改为 -> `cmp eax, 73h` (115)
// 指令: 83 F8 72 位于 0x005C973A, 立即数在 +2 处。
static constexpr DWORD kGetEquipDataPath_cmp_v2_114_imm = 0x005C973A + 2;

void AttachShoulderSlotsFix() {
    // 仅更改立即数；条件跳转保持正确。
    Patch1(kGetEquipDataPath_cmp_v2_114_imm, 0x73);
}

iscorrectbodypart.cpp
这确保客户端正确识别肩饰的身体部位 (body part)：

#include "pch.h"
#include "hook.h"

// -----------------------------------------------------------------------------
// is_correct_bodypart 重写 (detour)
// -----------------------------------------------------------------------------
// 客户端函数:
//   int __cdecl is_correct_bodypart(int nItemID, int nBodyPart, int nGender) @ 0x00460358
// 目标:
//   添加分类 115 -> 将其视为 nBodyPart == 20。
static auto is_correct_bodypart = reinterpret_cast<int(__cdecl*)(int, int, int)>(0x00460358);

static bool is_weapon_category(int v4) {
    const int itemCategory = v4;
    const int categoryTens = itemCategory / 10;
    return categoryTens == 13 || categoryTens == 14 || categoryTens == 16 || categoryTens == 17;
}

static int is_correct_bodypart_category_182(int nBodyPart) {
    if (nBodyPart == 21 || nBodyPart == 31)
        return 1;
    return nBodyPart == 39;
}

static int __cdecl is_correct_bodypart_hook(int nItemID, int nBodyPart, int nGender) {
    const int itemCategory = nItemID / 10000;
    switch (itemCategory) {
        case 119:
            return nBodyPart == 10;
        case 100:
            return nBodyPart == 1;
        case 101:
            return nBodyPart == 2;
        case 102:
            return nBodyPart == 3;
        case 103:
            return nBodyPart == 4;
        case 104:
        case 105:
            return nBodyPart == 5;
        case 106:
            return nBodyPart == 6;
        case 107:
            return nBodyPart == 7;
        case 108:
            return nBodyPart == 8;
        case 109:
            return nBodyPart == 10;
        case 110:
            return nBodyPart == 9;
        case 111:
            if (nBodyPart == 12 || nBodyPart == 13 || nBodyPart == 15)
                return 1;
            return nBodyPart == 16;
        case 112:
            if (nBodyPart == 17)
                return 1;
            return nBodyPart == 51;
        case 113:
            return nBodyPart == 50;
        case 114:
            return nBodyPart == 49;
        case 115:
            return nBodyPart == 20;
        case 180:
            // 特殊情况: 1802100 遵循与分类 182 相同的规则。
            if (nItemID == 1802100)
                return is_correct_bodypart_category_182(nBodyPart);
            if (nBodyPart == 14 || nBodyPart == 30)
                return 1;
            return nBodyPart == 38;

        case 181:
            switch (nItemID) {
                case 1812000:
                    if (nBodyPart == 23 || nBodyPart == 34)
                        return 1;
                    return nBodyPart == 42;
                case 1812001:
                    if (nBodyPart == 22 || nBodyPart == 33)
                        return 1;
                    return nBodyPart == 41;
                case 1812002:
                    return nBodyPart == 24;
                case 1812003:
                    return nBodyPart == 25;
                case 1812004:
                    if (nBodyPart == 26 || nBodyPart == 35)
                        return 1;
                    return nBodyPart == 43;
                case 1812005:
                    if (nBodyPart == 27 || nBodyPart == 36)
                        return 1;
                    return nBodyPart == 44;
                case 1812006:
                    if (nBodyPart == 28 || nBodyPart == 37)
                        return 1;
                    return nBodyPart == 45;
                case 1812007:
                    if (nBodyPart == 46 || nBodyPart == 47)
                        return 1;
                    return nBodyPart == 48;
                default:
                    return 0;
            }

        case 182:
            return is_correct_bodypart_category_182(nBodyPart);
        case 183:
            if (nBodyPart == 29 || nBodyPart == 32)
                return 1;
            return nBodyPart == 40;
        case 190:
            return nBodyPart == 18;
        case 191:
            return nBodyPart == 19;
        // case 192:
        // 	return nBodyPart == 20;
        case 194:
            return nBodyPart == 1000;
        case 195:
            return nBodyPart == 1001;
        case 196:
            return nBodyPart == 1002;
        case 197:
            return nBodyPart == 1003;
        default:
            if (!is_weapon_category(itemCategory))
                return 0;
            return nBodyPart == 11;
    }
}

void AttachIsCorrectBodyPartFix() {
    ATTACH_HOOK(is_correct_bodypart, is_correct_bodypart_hook);
}

getbodypartfromitem.cpp
这将更新函数，以便客户端从物品中正确读取身体部位：

#include "pch.h"
#include "hook.h"

// -----------------------------------------------------------------------------
// get_bodypart_from_item 重写 (detour)
// -----------------------------------------------------------------------------
// 客户端函数:
//   int __cdecl get_bodypart_from_item(int nItemID, int nGender, int *aBodyParts, int bWriteAll) @ 0x004606A0
static auto get_bodypart_from_item = reinterpret_cast<int(__cdecl*)(int, int, int*, int)>(0x004606A0);

static bool is_weapon_category(int itemCategory) {
    const int categoryTens = itemCategory / 10;
    return categoryTens == 13 ||
           categoryTens == 14 || categoryTens == 16 || categoryTens == 17;
}

static int write_bodyparts(int* outBodyParts, bool writeAll, std::initializer_list<int> parts) {
    if (parts.size() == 0)
        return 0;
    outBodyParts[0] = *parts.begin();
    if (!writeAll)
        return 1;

    int i = 0;
    for (int part : parts)
        outBodyParts[i++] = part;
    return i;
}

static int write_bodyparts_category_182(int* outBodyParts, bool writeAll) {
    return write_bodyparts(outBodyParts, writeAll, {21, 31, 39});
}

static int __cdecl get_bodypart_from_item_hook(int nItemID, int nGender, int* aBodyParts, int bWriteAll) {
    const int itemCategory = nItemID / 10000;
    const bool writeAll = bWriteAll != 0;

    switch (itemCategory) {
        case 119:
        case 109:
            aBodyParts[0] = 10;
            return 1;
        case 100:
            aBodyParts[0] = 1;
            return 1;
        case 101:
            aBodyParts[0] = 2;
            return 1;
        case 102:
            aBodyParts[0] = 3;
            return 1;
        case 103:
            aBodyParts[0] = 4;
            return 1;
        case 104:
        case 105:
            aBodyParts[0] = 5;
            return 1;
        case 106:
            aBodyParts[0] = 6;
            return 1;
        case 107:
            aBodyParts[0] = 7;
            return 1;
        case 108:
            aBodyParts[0] = 8;
            return 1;
        case 110:
            aBodyParts[0] = 9;
            return 1;
        case 111:
            return write_bodyparts(aBodyParts, writeAll, {12, 13, 15, 16});
        case 112:
            return write_bodyparts(aBodyParts, writeAll, {17, 51});
        case 113:
            aBodyParts[0] = 50;
            return 1;
        case 114:
            aBodyParts[0] = 49;
            return 1;
        case 115:
            aBodyParts[0] = 20;
            return 1;
        case 180:
            // 特殊情况: 1802100 遵循与分类 182 相同的规则。
            if (nItemID == 1802100)
                return write_bodyparts_category_182(aBodyParts, writeAll);
            return write_bodyparts(aBodyParts, writeAll, {14, 30, 38});
        case 181:
            switch (nItemID) {
                case 1812000:
                    return write_bodyparts(aBodyParts, writeAll, {23, 34, 42});
                case 1812001:
                    return write_bodyparts(aBodyParts, writeAll, {22, 33, 41});
                case 1812002:
                    aBodyParts[0] = 24;
                    return 1;
                case 1812003:
                    aBodyParts[0] = 25;
                    return 1;
                case 1812004:
                    return write_bodyparts(aBodyParts, writeAll, {26, 35, 43});
                case 1812005:
                    return write_bodyparts(aBodyParts, writeAll, {27, 36, 44});
                case 1812006:
                    return write_bodyparts(aBodyParts, writeAll, {28, 37, 45});
                case 1812007:
                    // 注意: 原始客户端在索引 3 处写入第 3 个身体部位（跳过索引 2）。
                    aBodyParts[0] = 46;
                    if (!writeAll)
                        return 1;
                    aBodyParts[1] = 47;
                    aBodyParts[3] = 48;
                    return 3;
                default:
                    return write_bodyparts_category_182(aBodyParts, writeAll);
            }
        case 182:
            return write_bodyparts_category_182(aBodyParts, writeAll);
        case 183:
            return write_bodyparts(aBodyParts, writeAll, {29, 32, 40});
        case 190:
            aBodyParts[0] = 18;
            return 1;
        case 191:
            aBodyParts[0] = 19;
            return 1;
        // case 192:
        // 	aBodyParts[0] = 20;
        // 	return 1;
        case 194:
            aBodyParts[0] = 1000;
            return 1;
        case 195:
            aBodyParts[0] = 1001;
            return 1;
        case 196:
            aBodyParts[0] = 1002;
            return 1;
        case 197:
            aBodyParts[0] = 1003;
            return 1;
        default:
            if (!is_weapon_category(itemCategory))
                return 0;
            aBodyParts[0] = 11;
            return 1;
    }
}

void AttachGetBodyPartFromItemFix() {
    ATTACH_HOOK(get_bodypart_from_item, get_bodypart_from_item_hook);
}

WZ 修改

准备好您的肩饰装备！将它们添加到 Accessory 文件夹中（ID 范围 1152000 --- 1153000）并配置对应的字符串 (strings)。

附加的客户端视觉修复

为了防止旧的怪物装备 (Mob Equip) 红色背景错位，我们不要移动真实的装备槽图表。相反，我们使用 hook 直接在客户端中纠正视觉表现。

此 hook 会将肩饰物品图标的绘制重定向到真实的肩饰位置，并确保鼠标悬停在视觉上的肩饰槽时，提示框 (tooltip) 会正确返回 BodyPart 20。在您的注入器文件夹中创建一个名为 shoulderdraw.cpp 的新文件：

shoulderdraw.cpp

#include "pch.h"
#include "hook.h"
#include <windows.h>

// -----------------------------------------------------------------------------
// 肩饰视觉修复
// -----------------------------------------------------------------------------
// 逻辑保持为:
//   肩饰物品类别 115xxxx -> BodyPart 20
//   服务端槽位 -> -20
//
// 我们不再移动真实的装备槽图表。
// 因为移动图表也会移动旧的怪物装备 (Mob Equip) 红色背景。
//
// 替代方案:
// 1. Hook 拦截 DrawItemIconForSlot。
// 2. 如果准备在旧的怪物装备位置绘制 115xxxx 物品，
//    则仅将图标绘制重定向到真实的肩饰位置。
// 3. Hook 拦截装备的鼠标碰撞测试 (hit-test)，使得悬停在真实的肩饰位置时返回 BodyPart 20。
// -----------------------------------------------------------------------------

static void WriteJump(DWORD src, void* dst, size_t len) {
    DWORD old;
    VirtualProtect((void*)src, len, PAGE_EXECUTE_READWRITE, &old);

    *(BYTE*)src = 0xE9;
    *(DWORD*)(src + 1) = (DWORD)dst - src - 5;
    for (size_t i = 5; i < len; ++i)
        *(BYTE*)(src + i) = 0x90;
    FlushInstructionCache(GetCurrentProcess(), (void*)src, len);
    VirtualProtect((void*)src, len, old, &old);
}

// -----------------------------------------------------------------------------
// Hook 拦截: CItemInfo::DrawItemIconForSlot @ 0x005D6458
//
// 旧怪物装备槽的原始绘制坐标:
//   x = 0x47
//   y = 0x109   // 0xE9 + 0x20
//
// 新的视觉肩饰槽坐标:
//   x = 0x89
//   y = 0x85    // 0x65 + 0x20
// -----------------------------------------------------------------------------
__declspec(naked) void DrawItemIconForSlot_ShoulderMove_Cave() {
    __asm {
        // 进入函数时的堆栈:
        // [esp+00] 返回地址
        // [esp+04] pCanvas
        // [esp+08] itemId
        // [esp+0C] x
        // [esp+10] y

        mov eax, [esp+08h] // 物品 ID (itemId)

        // 仅限肩饰物品范围: 1150000 <= itemId < 1160000
        cmp eax, 118C30h // 1150000
        jl normal_entry

        cmp eax, 11B1C0h // 1160000
        jge normal_entry

        // 仅当在旧的怪物装备位置绘制时
        cmp dword ptr [esp+0Ch], 47h // 旧 x = 71
        jne normal_entry

        cmp dword ptr [esp+10h], 109h // 旧 y = 265
        jne normal_entry

        // 仅将此图标绘制重定向到真实的肩饰槽
        mov dword ptr [esp+0Ch], 89h // 新 x
        mov dword ptr [esp+10h], 85h // 新 y = 0x65 + 0x20

    normal_entry:
        // 恢复从 0x005D6458 处覆盖的原始字节

        // B8 54 4E A9 00
        mov eax, 00A94E54h

        // E8 36 A7 48 00 -> call 0x00A60B98
        mov edx, 00A60B98h
        call edx

        // 83 EC 68 53 56 57
        sub esp, 68h
        push ebx
        push esi
        push edi

        mov eax, 005D6468h
        jmp eax
    }
}

// -----------------------------------------------------------------------------
// Hook 拦截: sub_7FEC32 @ 0x007FEC32
//
// 这是装备窗口的鼠标碰撞测试 (hit-test)。
// 它决定鼠标悬停在哪个身体部位 (BodyPart)。
//
// 我们添加如下逻辑:
//   如果鼠标悬停在视觉肩饰槽上方，
//   则返回 BodyPart 20。
// -----------------------------------------------------------------------------
__declspec(naked) void EquipHitTest_ShoulderAsBodyPart20() {
    __asm {
        mov eax, [esp+4] // x
        mov edx, [esp+8] // y

        // 肩饰的视觉矩形范围:
        // x: 0x89 - 0xA8
        // y: 0x65 - 0x84
        cmp eax, 89h
        jle original_logic

        cmp eax, 0A9h
        jge original_logic

        cmp edx, 65h
        jle original_logic

        cmp edx, 85h
        jge original_logic

        // 视觉肩饰槽的行为应表现为 BodyPart 20
        mov eax, 20
        ret 8

    original_logic:
        // 重新实现原始 sub_7FEC32 逻辑
        xor edx, edx
        mov ecx, 00BE2264h

    loop_slots:
        cmp edx, 0Dh
        je next_slot

        cmp edx, 13h
        jle check_slot

        cmp edx, 2Fh
        jle next_slot

    check_slot:
        mov eax, [ecx-4]
        cmp eax, [esp+4]
        jge next_slot

        add eax, 20h
        cmp [esp+4], eax
        jge next_slot

        mov eax, [ecx]
        cmp eax, [esp+8]
        jge next_slot

        add eax, 20h
        cmp [esp+8], eax
        jl found_slot

    next_slot:
        add ecx, 8
        inc edx
        cmp ecx, 00BE23F4h
        jb loop_slots

        xor eax, eax
        ret 8

    found_slot:
        lea eax, [edx+1]
        ret 8
    }
}

void AttachShoulderDraw() {
    // 将肩饰图标从旧怪物装备位置重定向到真实的肩饰槽。
    WriteJump(0x005D6458, DrawItemIconForSlot_ShoulderMove_Cave, 16);

    // 确保悬停在视觉肩饰位置时的提示框 (tooltip) 解析为 BodyPart 20。
    WriteJump(0x007FEC32, EquipHitTest_ShoulderAsBodyPart20, 5);
}