Skip to content

Latest commit

 

History

History
111 lines (97 loc) · 5.67 KB

README.md

File metadata and controls

111 lines (97 loc) · 5.67 KB
Raw

colorsay

A CSGO plugin for displaying colored text.
Tested on Ubuntu 16.04.2 LTS (4.4.0-59-generic, x86_64), but should work any debian based distro.

I have no intention of creating a Windows version of this, but it should just be a matter of compiling.
This plugin uses the AlliedModders CSGO SDK mirror.

License: MIT

Table of Contents

Releases

Download either the .zip or .tar.gz and unpack it to ${CSGO_DS_DIR}/csgo/addons.

  • Latest
  • v1.0 - Added colorsay_version and colorsay_id
  • v0.9 - First release

Features

Server commands

These can be used through the server console, or through rcon

  • colorsay - All chat
  • colorsay_spec - Spectators
  • colorsay_t - Terrorists
  • colorsay_ct - Counter-Terrorists
  • colorsay_id - First argument is comma-separated steamIDs, text after is message sent to only those players
    Example: colorsay_id "STEAM_0:1:01234567,STEAM_0:1:76543210" This is a {#4}spooky{#1} message
    Note the citation marks around the steamIDs.
  • colorsay_version - Prints the version of the ColorSay plugin

Server convars

  • colorsay_allow_client - Enable to allow client commands (disabled by default)

Client commands

These can be used by players through their console.
By default these are disabled, but can be enabled with the server convar colorsay_allow_client 1.

  • colorsay say - All chat
  • colorsay say_team - Player's team chat
  • colorsay echo - Echo a message to yourself, only visible to you!
  • colorsay list - List all available colors, only visible to you!
  • colorsay help - Display available commands, or get help about a particular command

How to add color to your messages

All chat related commands are colorized by formatting the message with color tags.
A good way of familiarizing yourself with useage of color tags is to set up a test server with this plugin installed. Type colorsay_allow_client 1 in the server console, join the server, and play around with the colorsay command in your client console.

Color tags

A color tag starts with {# and ends with }. The text inside the tag defines what color to use.
To define a color you can either use their integer value, or their name.

Value Name Color
1 White #ffffff
2 Red #ee0202
3 Lavender #b981ef
4 Green #40fe40
5 Pale green #befe8f
6 Green yellow #a1fe47
7 Coral red #fe4040
8 Light grey #c4c9cf
9 Light Goldenrod #ece37a
10 Echo blue #aec1d7
11 Picton blue #5e97d8
12 Royal blue #4b69fe
13 Purple #8847fe
14 Neon purple #d22ce5
15 Vermilion #ea4b4b
16 Orange gold #e1ac39

Examples

  • colorsay I am {#royal blue}blue{#white} da ba dee da ba die...
  • colorsay I am {#12}blue{#1} da ba dee da ba die...
  • colorsay {#2}R{#16}a{#9}i{#4}n{#11}b{#12}o{#13}w

Compilation

You need

  • pkg-config
  • protoc 2.5.0
  • g++-4.6, and g++-4.6-multilib if you're compiling on a 64-bit machine.
  • git submodule init && git submodule update

protoc

A copy of the protobuf 2.5.0 source code is provided with the AlliedModders mirror, located in
hl2sdk-csgo/common/protobuf-2.5.0/src
But it seems to be missing some key compilation components (autogen.sh, configure),
so download it from source instead

You can follow the official installation guide, unless you're using a 64-bit distro, and want to run this 32-bit plugin on it. By default it will compile it as a 64-bit program and library, which can't be loaded into srcds_linux

To fix this run:

./configure --build=i686-pc-linux-gnu \
            --host=x86_64-pc-linux-gnu \
            "CFLAGS=-m32" "CXXFLAGS=-m32" "LDFLAGS=-m32"

instead of just ./configure.
Also, it will probably help to add --prefix=/usr as mentioned in the guide

Actually compiling the plugin

make

Installation

  • Run make install
    Or
  • Copy affesay.so and affesay.vdf into ${CSGO_DS_DIR}/csgo/addons.