[INC] Message Stocks

[OciXCrom]

https://raw.githubusercontent.com/OciXCrom/msgstocks/master/version.png​

This .inc file contains a bunch of functions that will make your life easier. The goal of it is to make the usage of message_begin functions a piece of cake, especially the SVC_TEMPENTITY ones.

Instead of having to do all of this just to create a single beam:

new iStartPos[3], iEndPos[3];
get_user_origin(id, iStartPos);
get_user_origin(id, iEndPos, 3);

message_begin(MSG_ALL, SVC_TEMPENTITY);
write_byte(TE_BEAMPOINTS);
write_coord(iStartPos[0]);
write_coord(iStartPos[1]);
write_coord(iStartPos[2]);
write_coord(iEndPos[0]);
write_coord(iEndPos[1]);
write_coord(iEndPos[2]);
write_short(g_iSprite);
write_byte(0);
write_byte(30);
write_byte(10);
write_byte(10);
write_byte(0);
write_byte(0);
write_byte(0);
write_byte(255);
write_byte(75);
write_byte(0);
message_end();

With using this library, we can do it as simple as this:

new iStartPos[3], iEndPos[3];
get_user_origin(id, iStartPos);
get_user_origin(id, iEndPos, 3);

te_create_beam_between_points(iStartPos, iEndPos, g_iSprite)

This saves a lot of time that you would spend searching for the write_ arguments, experimenting with the numbers and having to write all 20 arguments 1 by 1 and having a huge chance of messing some of them up.

Only the mandatory arguments in the stocks are required (e.g. starting position, sprite index, etc) and all other ones have a default value and are optional.

All of the stocks share 2 same arguments - receiver and bool:reliable - both optional and the second one is always the last argument in the natives. The first one controls who will see the message and the second one controls whether or not to use the reliable channel. With this being said, if receiver is set to 0 and reliable is true, the stock will use MSG_ALL as the message destination.

[ Click here for a list of all functions found in this library and documentation ]

[ Download msgstocks.inc ]​

 

[SergeyShorokhov]

Предлагаю сделать данные стоки в AMXX 1.8.3 стандартом. (в комплект)

 

[OciXCrom]

Предлагаю сделать данные стоки в AMXX 1.8.3 стандартом. (в комплект)

I already submitted a pull request to add these into AMXX 1.8.3. Not as stocks, but as natives, which is much better. Here's a link to the PR. This .inc file is a stock version of the PR for people who will want to use them in 1.8.2.

 

[SergeyShorokhov]

OciXCrom, спасибо, так как нужно

 

[fantom]

OciXCrom, Your PR failed in continuous-integration tests. Push empty commit to run tests again.
Details https://github.com/alliedmodders/amxmodx/pull/528

 

[OciXCrom]

OciXCrom, Your PR failed in continuous-integration tests. Push empty commit to run tests again.
Details https://github.com/alliedmodders/amxmodx/pull/528

Yeah, I noticed that. It's because of one of the changes that were made to the AMXX build system yesterday. I'll run the tests again tomorrow since I can't access my computer at the moment.

 

[Nordic Warrior]

OciXCrom,

stock draw_status_icon(id, sprite[] = "", StatusIconFlags:status = StatusIcon_Hide, r = 0, g = 0, b = 0, bool:reliable = true)
{
    if(id && !is_user_connected(id))
        return 0;

    static MSG_StatusIcon;

    if(!MSG_StatusIcon)
        MSG_StatusIcon = get_user_msgid("StatusIcon");

    message_begin(get_msg_destination(id, reliable), MSG_StatusIcon, .player = id);
    write_byte(_:status);
+   write_string(sprite);

    if(status)
    {
-       write_string(sprite);
        write_byte(r);
        write_byte(g);
        write_byte(b);
    }

    message_end();
    return 1;
}