Motd (Metamod:Source)
Contents
Message of the Day (MOTD)
Showing a MOTD Panel
To show a MOTD, you'll need to add this code to your project. You'll also need to include an MRecipientFilter class. You may want to make it part of a class instance in your program, but this will work as an example.
First add this to AllPluginsLoaded:
mVGUIMenu = UserMessageIndex("VGUIMenu");
Then add this to your project:
void ShowMOTD(int index, char *title, char *msg, int type, char *cmd) { bf_write *buffer; MRecipientFilter filter; filter.AddRecipient(index); buffer = engine->UserMessageBegin(&filter, mVGUIMenu); buffer->WriteString("info"); buffer->WriteByte(1); if(cmd != NULL) buffer->WriteByte(4); else buffer->WriteByte(3); buffer->WriteString("title"); buffer->WriteString(title); buffer->WriteString("type"); switch(type) { case TYPE_TEXT: buffer->WriteString("0"); //TYPE_TEXT = 0, just display this plain text break; case TYPE_INDEX: buffer->WriteString("1"); //TYPE_INDEX, lookup text & title in stringtable break; case TYPE_URL: buffer->WriteString("2"); //TYPE_URL, show this URL break; case TYPE_FILE: buffer->WriteString("3"); //TYPE_FILE, show this local file break; } buffer->WriteString("msg"); buffer->WriteString(msg); // msg must not be greater than 192 characters if(cmd != NULL) { buffer->WriteString("cmd"); buffer->WriteString(cmd); // exec this command if panel closed } engine->MessageEnd(); return ; }
Displaying Your Info in the MOTD Panel
The types of MOTD available are:
TYPE_TEXT = 0 // just display this plain text TYPE_INDEX = 1 // lookup text & title in stringtable TYPE_URL = 2 // show this URL TYPE_FILE = 3 // show this local file
For example: To show a website
ShowMOTD( pEdict, "http://www.yahoo.com", "Yahoo.com !", TYPE_URL, NULL )
To show some text
ShowMOTD( pEdict, "Some Text", "A Title", TYPE_TEXT, NULL )
Using TYPE_INDEX to Send More Than 255 Characters
TYPE_TEXT is limited to 255 characters. To send a longer piece of info, we need to create an entry in the StringTables and reference that using TYPE_INDEX.
First, we need to have a NetworkStringTableContainer:
INetworkStringTableContainer *m_NetworkStringtable;
Then, using the FIND_IFACE macro from the sample_mm plugin, we need to get the INetworkStringTable interface in Load():
strcpy(iface_buffer, INTERFACENAME_NETWORKSTRINGTABLESERVER); FIND_IFACE(engineFactory, m_NetworkStringtable, num, iface_buffer, INetworkStringTableContainer *);
Next, we can setup our string table entry:
char msg[4096]; // copy your info into msg // if you add any html tags, your msg will be formatted as html (for example <b>bold text</b>) INetworkStringTable *pInfoPanel = m_NetworkStringtable->FindTable("InfoPanel"); if (pInfoPanel) { bool save = m_Engine->LockNetworkStringTables(false); int StrIdx = pInfoPanel->AddString("myinfo"); pInfoPanel->SetStringUserData(StrIdx, 4096, msg); m_Engine->LockNetworkStringTables(save); } }
NOTE: 4096 characters is the max length, you should use the smallest size that your string data will fit into.
Finally you can show the MOTD panel with the info you added to the string tables:
ShowMOTD( EntityIndex, "myinfo", "My MOTD Window Title", 1, "" );
NOTE: I've tested this using html formatted text. I assume that the maximum length for standard text would also be 4096 characters. --L. Duke 00:45, 18 March 2006 (EST)