[rtxa]

HL Player Models API



☉ Introduction

This API for Half-Life was made with the aim in mind of being able to use differents skins in Teamplay mode. Normally this is not possible without breaking the gameplay or making a lot of changes that will imply modify every plugin making it unpractical.

Now with this you can add classes for a Zombie Mod, etc.

☉ Description

This let you set custom models to the players and reset them to the default model. The custom model will stay until the player disconnects or you reset it manually.

☰ Natives

PHP Code:

/**
 * Sets a custom player model.
 *
 * @param id      Player index
 * @param model   Model path
 */
native hl_set_player_model(id, const model[])

/**
 * Restores default model of player.
 *
 * @param id    Player index
 */
native hl_reset_player_model(id)

/**
 * Returns the team id of the player, and optionally retrieves the name of
 * the team.
 *
 * @param id            Player index
 * @param team          Buffer to store team name
 * @param len           Maximum buffer length
 */
native hl_get_player_team(id, team[] = "", len = 0)

/**
 * Sets the player's team without killing him.
 *
 * @param id        Player index
 * @param teamid    Team id
 */
native hl_set_player_team(id, teamid) 


☰ Requirements

• Last AMXX 1.9 or newer.
• Orpheu 2.6.3 or ReAPI if you are using ReHLDS.

⚙ Installation

1. Download the attached files and extract them in your scripting folder, then type #include <hl_player_models_api> in your plugin to be able to use the functions.
2. Compile hl_player_models_api.sma and add it to your plugin list in plugins.ini to turn on the API.

The API is ready to use.

☉ Notes

• Remember to install Orpheu or ReAPI (ReHLDS) in order to use the API.
• Any custom model that is going to be set to the player has to be previously precached.
• It's not necessary the models to be located in models/player/x/x.mdl. Also, you can use an sprite as a player model if you want.
• If you want to know what model is using a player, save the number that precache_model() gives you, associate the value with a name. Then, you will be able to know the player's model by his modelindex.

⛏ To do

• ☑ Add support for ReApi (ReHLDS).
• ☐ (Debatable) Probably the server will crash if you try to change the team of 32 players at the same time (Fullupdate spam?). Make a queue and delay team changes to avoid any issue (That will make the plugin much more safer for team changing unlike natives from HL Stocks).

⚛ Sample plugin

I leave you this sample plugin called “Skin Menu” so you can test it. The skin list can be set in AMX Mod X config's folder creating this file using following format.

skin-list.cfg

PHP Code:

Normal Barney;  models/player/barney/barney.mdl
Postal;         models/madskillz/postal.mdl
Banana Dancer;  models/madskillz/bananadancer.mdl
Bender;         models/madskillz/bender.mdl
Scream;         models/madskillz/scream.mdl
Droid;          models/madskillz/droid.mdl
Cool Barney;    models/madskillz/clanfn.mdl 


• say !skins [Displays a menu where he can choose a custom skin]
• say !rskin [Reset player to his original skin]

[rtxa]

## ☰ Changelog

Version 1.2

- Fixed possible crash with Info_RemoveKeyValue().
- Added ReAPI support (ReHLDS servers).

[gabuch2]

hl_get_player_team() is unable to get the team index of the player. Returns 0 with a malformed string.

Tested with bugfixed HL 0.2.51 (59a2950), the latest version of ReHLDS.

Tested with both Orpheu (my own signatures) and ReAPI.

new teambuf[32];
new teamid = hl_get_player_team(id, teambuf, charsmax(teambuf));
server_print("TEAMID %d - %s", teamid, teambuf);

TEAMID 0 - k Mesa

"mp_teamlist" is "Black Mesa;HECU"

EDIT: Managed to solve it by editing the offsets-cbaseplayer.txt file. I just shifted the offsets by 4.

"m_szTeamName"  // char[16]
{
	"type"      "string"
	"size"      "16"

	"windows"   "1532"
	"linux"     "1552"
	"mac"       "1552"
}

[rtxa]

Originally Posted by Gabe Iggy hl_get_player_team() is unable to get the team index of the player. Returns 0 with a malformed string. Tested with bugfixed HL 0.2.51 (59a2950), the latest version of ReHLDS. Tested with both Orpheu (my own signatures) and ReAPI. new teambuf[32]; new teamid = hl_get_player_team(id, teambuf, charsmax(teambuf)); server_print("TEAMID %d - %s", teamid, teambuf); TEAMID 0 - k Mesa "mp_teamlist" is "Black Mesa;HECU" EDIT: Managed to solve it by editing the offsets-cbaseplayer.txt file. I just shifted the offsets by 4. "m_szTeamName" // char[16] { "type" "string" "size" "16" "windows" "1532" "linux" "1552" "mac" "1552" }

Hello gabe, strange error, with last version of ReHlds, can you tell me the exact the build? Also bugfixedhl hasn't been updated for a long time ago, would you mind to try this one from this CI i made a couple days ago? https://github.com/rtxa/BugfixedHL/actions

Strange to me that you just needed to increase that offset, i wonder if there's a new HL Build

[jao6622]

Hi, compiled everything but when the API loads still looking for Orpheu and it doesn't works

Running lastest ReHLDS version with ReAPI module running

[lexzor]

even if you install orpheu and add function file this error is thrown:

L 04/05/2022 - 13:07:16: [ORPHEU] Function "SV_FullClientUpdate" not found
L 04/05/2022 - 13:07:16: [AMXX] Displaying debug trace (plugin "hl_player_models_api.amxx", version "1.2")
L 04/05/2022 - 13:07:16: [AMXX] Run time error 10: native error (native "OrpheuGetFunction")
L 04/05/2022 - 13:07:16: [AMXX]    [0] hl_player_models_api.sma::plugin_init (line 64)

[rtxa]

Thanks for reporting the issues, lexzor and jao6622. In a few days I should be uploading a new version with the fixes. Also I'm planning to improve the Skin Chooser plugin to show the skin selected in third-person mode.

Lexzor, I can't reproduce your error, make sure you are using latest HLDS build from SteamCMD and AMXX 1.9 or 1.10.

jao6622, seems that my way to detect when ReAPI or Orpheu is available is not working as expected, should be fixed in next release.

[gabuch2]

Hello, I was wondering how did you obtain the client_s_offsets values. I want to do a similar implementation in another mod and thus I need to find the values.

[rtxa]

Originally Posted by gabuch2 Hello, I was wondering how did you obtain the client_s_offsets values. I want to do a similar implementation in another mod and thus I need to find the values.

Not sure really, I got the values from SV_FullUpdate and client_s_offsets luckily from ConnorMcLeod. First of all, you need to learn how to get signatures, there're many posts on AlliedMods about this using a program called IDA. Anyway, you should ask this in the Discord server, pretty sure there are some signature experts where you can ask.