본문으로 건너뛰기
cccskills
무료GitHub에 공개

find-CCSPlayer_ItemServices_DropActivePlayerWeapon

Find and identify the CCSPlayer_ItemServices_DropActivePlayerWeapon virtual function in CS2 binary using IDA Pro MCP. Use this skill when reverse engineering CS2 server.dll or libserver.so to locate the "drop the currently held weapon" vfunc by RTTI-walking the CCSPlayer_ItemServices vtable and confirming the candidate reads the player's active weapon and forwards it, with a computed toss velocity, into the weapon's own drop vfunc. Trigger: CCSPlayer_ItemServices_DropActivePlayerWeapon

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md6.2 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Find CCSPlayer_ItemServices_DropActivePlayerWeapon

Locate CCSPlayer_ItemServices_DropActivePlayerWeapon vfunc in CS2 server.dll or libserver.so using IDA Pro MCP tools.

Method

1. Load CCSPlayer_ItemServices VTable

ALWAYS Use SKILL /get-vtable-address with class_name=CCSPlayer_ItemServices.

mcp__ida-pro-mcp__find_regex pattern="22CCSPlayer_ItemServices"
mcp__ida-pro-mcp__xrefs_to addrs="<name_string_addr>"      # hit - 8 = typeinfo
mcp__ida-pro-mcp__xrefs_to addrs="<typeinfo_addr>"          # hit - 8 = vtable candidate, keep offset_to_top==0

Linux 14168 reference: name string 22CCSPlayer_ItemServices at 0x8219d0, typeinfo at 0x2489888, primary vtable at 0x2489cf0.

2. Read VTable Slot 27

mcp__ida-pro-mcp__get_int addr="<vtable_va> + 0x10 + 27*8" ty="u64"

Linux 14168 reference: slot 27 (vfunc_offset = 0xD8) is at 0x2489dd8, function pointer 0x1578c30, size 0x131 (305 bytes).

3. Confirm the Candidate

Decompile the resolved function:

mcp__ida-pro-mcp__decompile addr="<slot_27_func_addr>"

Identification rules — DropActivePlayerWeapon takes no weapon/name argument beyond this (plus a small number of scalar/vector-ish trailing parameters used only to compute the toss impulse), and its body:

  1. First calls a small no-op-looking stub (nullsub_1463-style — a hook/telemetry point present on several ItemServices mutators, safe to ignore for identification purposes).
  2. Fetches the owning pawn via the lazy-accessor pattern (if (!v) { nullsub_1480(this); v = *(this+56); }) seen throughout this class.
  3. Reads the pawn's active weapon pointer via the pawn's weaponServices+3344 member and an internal GetActiveWeapon-style helper (sub_17604F0-equivalent on the reference build) — not a weapon passed in as an argument. This "no explicit weapon argument, reads the active one internally" shape is what distinguishes it from a generic DropWeapon(pWeapon) overload.
  4. If an active weapon was found, checks the weapon's "can be manually dropped" flag (a vfunc call at offset 232, i.e. slot 29 of the weapon's own vtable) and, if allowed, computes a toss velocity/angle from the trailing scalar/vector parameters and calls the weapon's own drop vfunc (a second vcall at offset 232 — same slot, different receiver — passing the computed velocity struct).
  5. If the "can be manually dropped" check fails, instead calls the weapon's drop vfunc with a null velocity pointer (an unconditional/forced drop with no toss impulse).

Linux 14168 reference: the two calls both target *(_QWORD*)v7 + 232 (offset 0xE8, i.e. slot 29 of the weapon's own vtable, a distinct class from CCSPlayer_ItemServices — do not confuse this internal vcall offset with DropActivePlayerWeapon's own slot 27 in CCSPlayer_ItemServices).

If the candidate does not match, STOP and report to user.

4. Generate Function Signature

ALWAYS Use SKILL /generate-signature-for-function with addr=<DropActivePlayerWeapon_func_addr> to generate a robust and unique func_sig.

5. Write IDA Analysis Output as YAML

ALWAYS Use SKILL /write-vfunc-as-yaml to write the analysis results.

Required parameters:

  • func_name: CCSPlayer_ItemServices_DropActivePlayerWeapon
  • func_addr: <DropActivePlayerWeapon_func_addr>
  • func_sig: The validated signature from step 4

VTable parameters:

  • vtable_name: CCSPlayer_ItemServices
  • vfunc_offset: 0xD8 (27 * 8)
  • vfunc_index: 27

Function Characteristics

  • Purpose: Drops the player's currently active/held weapon, computing a toss velocity for it if the weapon permits manual drops, or force-dropping it with no toss impulse otherwise.
  • Binary: server.dll / libserver.so
  • Parameters: (this, <toss-velocity/angle-related scalars>) — no explicit weapon pointer; the active weapon is looked up internally.
  • Return value: not consumed in a way that suggests a meaningful return type (effectively void)
  • VTable: CCSPlayer_ItemServices, slot 27 (vfunc_offset = 0xD8) on the Linux 14168 reference build.

Discovery Strategy

  1. RTTI-walk CCSPlayer_ItemServices's primary vtable via its typeinfo name string 22CCSPlayer_ItemServices.
  2. Read slot 27 directly (per the config's FUNC_VTABLE_RELATIONS mapping, ground truth for this build).
  3. Confirm by decompiled shape: no explicit weapon argument (reads the active weapon internally), a can-manually-drop gate, and two mutually-exclusive calls into the weapon's own drop vfunc (with vs. without a computed toss velocity).

This is robust because:

  • The vtable slot index is what CSS's runtime hook actually targets, so validating directly against slot 27 (per provided ground truth) rather than re-deriving it from an unrelated anchor keeps this skill both simple and authoritative.
  • "No weapon argument, active weapon read internally, two drop-vfunc call sites gated by a manual-drop flag" is distinctive enough to disambiguate from sibling ItemServices mutators (e.g. RemoveWeapons, which iterates all weapons rather than just the active one — see the sibling skill find-UTIL_PlayerSlotToPlayerController-AND-FireTargets-AND-CCSPlayer_ItemServices_RemoveWeapons).

Output YAML Format

The output YAML filename depends on the platform:

  • server.dll -> CCSPlayer_ItemServices_DropActivePlayerWeapon.windows.yaml
  • libserver.so -> CCSPlayer_ItemServices_DropActivePlayerWeapon.linux.yaml

Fields: func_name, func_va, func_rva, func_size, func_sig, vtable_name, vfunc_offset, vfunc_index.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Clean up the local workspace after a dev branch has been merged into main. Verifies the current dev branch is fully merged into origin/main, then switches to main, pulls the latest, deletes the local dev branch, and deletes the remote dev branch if it still exists. STOPS and warns the user if the current branch is not yet merged. Triggers: cleanup workspace, cleanup branch, delete merged branch, finish dev branch, post-merge cleanup

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mrc4tt/CS2_VibeSignatures32026년 10월 15일 업데이트

Convert an existing find-XXXX SKILL.md into a preprocessor Python script, updating configs/<GAMEVER>.yaml and removing the old SKILL.md. Covers xref-string-based and LLM_DECOMPILE-based discovery patterns.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mrc4tt/CS2_VibeSignatures32026년 10월 15일 업데이트

Create an Agent SKILL.md fallback for an existing find-XXXX finder that relies on a fragile discovery foundation — above all LLM_DECOMPILE (patterns C/D/E), which matches the decompiled shape of a predecessor function against a stored reference and breaks when a symbol is inlined or de-inlined in a way the reference does not cover. The generated fallback coexists with the preprocessor and runs only when it returns failure, recovering every target robustly by decompiling the predecessor and following the inline/de-inline boundary with semantic anchors. Use when a finder broke on a game update, or you want to durably backstop one before it does. The recipe generalizes to any finder foundation. Triggers: create agent skill fallback, add SKILL.md fallback, robust fallback for finder, backstop LLM_DECOMPILE finder, final guarantee skill

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mrc4tt/CS2_VibeSignatures32026년 10월 15일 업데이트

Create a new cpp_tests entry for validating a C++ interface vtable layout against binary reference YAMLs. Creates the .cpp test file in cpp_tests/ and appends a configs/<GAMEVER>.yaml entry under cpp_tests:. Use when a user asks to add vtable layout validation for a new hl2sdk_cs2 interface class.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mrc4tt/CS2_VibeSignatures32026년 10월 15일 업데이트

create-pr

무료

Create a GitHub pull request from staged task changes or an already-committed current branch. Deliver source/config/ reference changes together with their computed source-owned `bin_artifacts` closure. PR validation routing is owned by the default-branch trusted workflow; snapshots, gamedata, and manifests are Release-derived only.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mrc4tt/CS2_VibeSignatures32026년 10월 15일 업데이트

Create a new find-XXXX preprocessor Python script from scratch (no existing SKILL.md), add configs/<GAMEVER>.yaml skill and symbol entries. Covers xref-string-based and LLM_DECOMPILE-based discovery patterns. Use when a GitHub issue or user instruction specifies a new function to find.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mrc4tt/CS2_VibeSignatures32026년 10월 15일 업데이트

mrc4tt의 스킬 모두 보기

이 스킬의 문제 신고