Sourcemod - Revision history

Neoony: Add info

2024-02-06T16:51:05Z

Add info

← Older revision		Revision as of 16:51, 6 February 2024
Line 10:		Line 10:

	Make sure to edit following file: .../empires/empires/addons/metamod.vdf <br />		Make sure to edit following file: .../empires/empires/addons/metamod.vdf <br />
	Put the following in: <br />		Put the following in (overwrite what is already there): <br />
	<pre>"Plugin"		<pre>"Plugin"
	{		{

Neoony: I hate this wiki formatting

2024-02-06T16:40:52Z

I hate this wiki formatting

← Older revision		Revision as of 16:40, 6 February 2024
Line 17:		Line 17:

	Also just in case, remove any x64 files in metamod <br />		Also just in case, remove any x64 files in metamod <br />
	Windows:		Windows: <br />
	addons\metamod_x64.vdf <br />		addons\metamod_x64.vdf <br />
	addons\metamod\bin\win64 (delete whole folder) <br />		addons\metamod\bin\win64 (delete whole folder) <br />
Line 23:		Line 23:
	addons\sourcemod\bin\sourcemod_mm.x64.dll <br />		addons\sourcemod\bin\sourcemod_mm.x64.dll <br />

	Linux:		Linux: <br />
	addons\metamod_x64.vdf <br />		addons\metamod_x64.vdf <br />
	addons\metamod\bin\linux64 (delete whole folder) <br />		addons\metamod\bin\linux64 (delete whole folder) <br />

Neoony: Fix

2024-02-06T16:40:19Z

Fix

← Older revision		Revision as of 16:40, 6 February 2024
Line 17:		Line 17:

	Also just in case, remove any x64 files in metamod <br />		Also just in case, remove any x64 files in metamod <br />
			Windows:
	addons\metamod_x64.vdf <br />		addons\metamod_x64.vdf <br />
	addons\metamod\bin\win64 (delete whole folder) <br />		addons\metamod\bin\win64 (delete whole folder) <br />
	addons\sourcemod\bin\x64		addons\sourcemod\bin\x64 (delete whole folder) <br />
	addons\sourcemod\bin\sourcemod_mm.x64.dll		addons\sourcemod\bin\sourcemod_mm.x64.dll <br />

			Linux:
			addons\metamod_x64.vdf <br />
			addons\metamod\bin\linux64 (delete whole folder) <br />
			addons\metamod\bin\linuxsteamrt64 (delete whole folder) <br />
			addons\sourcemod\bin\x64 (delete whole folder) <br />
			addons\sourcemod\bin\sourcemod_mm.x64.so <br />
	<br />		<br />
	It was once causing some issue for someone. Empires does not support x64, so just delete any such files to avoid any issues. <br />		It was once causing some issue for someone. Empires does not support x64, so just delete any such files to avoid any issues. <br />

Neoony: Fix

2024-02-06T16:31:58Z

Fix

← Older revision		Revision as of 16:31, 6 February 2024
Line 19:		Line 19:
	addons\metamod_x64.vdf <br />		addons\metamod_x64.vdf <br />
	addons\metamod\bin\win64 (delete whole folder) <br />		addons\metamod\bin\win64 (delete whole folder) <br />
			addons\sourcemod\bin\x64
			addons\sourcemod\bin\sourcemod_mm.x64.dll
	<br />		<br />
	It was once causing some issue for someone <br />		It was once causing some issue for someone. Empires does not support x64, so just delete any such files to avoid any issues. <br />

	== Developing Plugins ==		== Developing Plugins ==

Neoony: Edit the MM and SM installation steps

2024-02-06T16:28:01Z

Edit the MM and SM installation steps

← Older revision		Revision as of 16:28, 6 February 2024
Line 3:		Line 3:
	== Installation ==		== Installation ==
	* Install MetaMod:		* Install MetaMod:
	** Download for [~~http~~://www.~~metamodsource~~.net/downloads~~/mmsource-1.10.6-windows.zip Windows] or [http://www.metamodsource.net/downloads/mmsource-1.10.6-windows.tar~~.~~gz Linux~~ ]		** Download for [https://www.sourcemm.net/downloads.php?branch=stable Metamod]
	** Copy the Addons folder into your empires folder		** Copy the Addons folder into your empires folder
	** Start the game
	** Enter meta version (if the installation was succesful you should see the metamod version)
	* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable		* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable
	* Copy the cfg and addons folders to your empires folder		* Copy the cfg and addons folders to your empires folder
	* Install some [[Sourcemod Plugins]]		* Install some [[Sourcemod Plugins]]

			Make sure to edit following file: .../empires/empires/addons/metamod.vdf <br />
			Put the following in: <br />
			<pre>"Plugin"
			{
			"file" "empires/addons/metamod/bin/server"
			}</pre>

			Also just in case, remove any x64 files in metamod <br />
			addons\metamod_x64.vdf <br />
			addons\metamod\bin\win64 (delete whole folder) <br />
			<br />
			It was once causing some issue for someone <br />

	== Developing Plugins ==		== Developing Plugins ==

Neoony: /* Developing Plugins */

2023-12-02T16:47:52Z

Developing Plugins

← Older revision		Revision as of 16:47, 2 December 2023
Line 12:		Line 12:

	== Developing Plugins ==		== Developing Plugins ==
	Empires has a lot of [[Game_events_added \| game events]] you can make use of. For an example of plugins you can make see our [https://git.~~emiresmod~~.com/sourcemod/ sourcemod repository].		Empires has a lot of [[Game_events_added \| game events]] you can make use of. For an example of plugins you can make see our [https://git.empiresmod.com/sourcemod/ sourcemod repository].

	== Compiling from Source ==		== Compiling from Source ==

Smithy at 19:29, 10 February 2022

2022-02-10T19:29:05Z

← Older revision		Revision as of 19:29, 10 February 2022
Line 112:		Line 112:
	\x07008000 for enabled, unlocked or simply positive [green]		\x07008000 for enabled, unlocked or simply positive [green]
	\x07b30000 for disabled, locked or simply negative, also for warnings [red]</pre>		\x07b30000 for disabled, locked or simply negative, also for warnings [red]</pre>

			[[Category:Sourcemod]]

Xyaminou at 15:08, 1 April 2021

2021-04-01T15:08:24Z

← Older revision		Revision as of 15:08, 1 April 2021
Line 13:		Line 13:
	== Developing Plugins ==		== Developing Plugins ==
	Empires has a lot of [[Game_events_added \| game events]] you can make use of. For an example of plugins you can make see our [https://git.emiresmod.com/sourcemod/ sourcemod repository].		Empires has a lot of [[Game_events_added \| game events]] you can make use of. For an example of plugins you can make see our [https://git.emiresmod.com/sourcemod/ sourcemod repository].

			== Compiling from Source ==
			Thanks to people smarter than me, compiling from source is pretty easy. <br />
			Take your source-file or source-text and pop it in this: http://www.sourcemod.net/compiler.php <br />
			Download your compiled plugin, and put it in your sourcemod/plugins folder. <br />

			Or you can use spcomp.exe inside your sourcemod folders (\addons\sourcemod\scripting\spcomp.exe) (for windows) <br />
			Just drag and drop your source-file onto the .exe. <br />

			== Sourcemod offsets and signatures ==
			'''Get latest offsets ready to use here''' https://git.empiresmod.com/sourcemod/sourcemodoffsets <br />
			<br />
			If you have issues with invalid signatures. <br />
			Example: <br />
			<pre>L 03/18/2017 - 00:02:51: [SDKTOOLS] Invalid detour address passed - Disabling detour to prevent crashes
			L 03/18/2017 - 00:02:51: [SM] Exception reported: Entity Outputs are disabled - See error logs for details</pre>

			'''Choice 1.''' '''Just download latest ready to use offsets here:''' https://git.empiresmod.com/sourcemod/sourcemodoffsets <br />
			'''Choice 2.''' Replace the linux signatures in sdkhooks and sdktools files with the mac signatures. (this is already included in the above release) <br />
			This is rather temporary fix and needs testing <br />
			Example: <br />
			<pre>/* CBaseEntityOutput::FireOutput */
			"#default"
			{
			"Signatures"
			{
			"FireOutput"
			{
			"library" "server"
			"windows" "\x55\x8B\xEC\x81\x2A\x2A\x2A\x2A\x2A\xA1\x2A\x2A\x2A\x2A\x33\xC5\x89\x45\x2A\x8B\x45\x2A\x53\x56\x8B\x2A\x2A\x57\x8B\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\xC7"
			"linux" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
			"mac" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
			}
			}
			}</pre>

			== Dumping updated Sourcemod offsets and signatures ==
			Related thread: https://forums.empiresmod.com/index.php?threads/calculating-updated-sourcemod-vtable-offsets.20571/ <br />
			Tool needed: https://delftelectronics.nl/empires/tools/vtablescanner3.zip <br />
			The tool requires linux. If you are running 64bit linux, you will probably need to run the following to be able to run 32bit apps: <br />
			<pre>dpkg --add-architecture i386
			apt-get update
			apt install libc6:i386 libelf1:i386</pre>
			Unpack the vtablescanner3.zip anywhere in your linux. <br />
			Next you need a server.so file from your dedicated server which is located in /empires_dedicated/empires/bin <br />
			Copy server.so to the Release folder in the vtablescanner folder that you extracted. (vtablescanner/Release/server.so) <br />

			Now open your terminal inside the Release folder. <br />
			And enter the following command:
			<pre>LD_LIBRARY_PATH="./" ./vtabledump ./server.so '_ZTV10CEmpPlayer' >dump.txt</pre>
			The outputted RAW offsets are now located in vtablescanner/Release/dump.txt <br />
			<br />
			Now if you want to output a proper file for SourceMod. <br />
			Open the terminal again inside Release folder. <br />
			Type: <br />
			<pre>./createoffsetscript >dumpsmoffsets.txt</pre>
			This output file is the game.empires.txt which you can put into your: <br />
			\addons\sourcemod\gamedata\sdkhooks.games\custom\game.empires.txt <br />
			\addons\sourcemod\gamedata\sdktools.games\custom\game.empires.txt <br />
			<br />
			'''Also check this for offsets that need adjusting after a dump: https://git.empiresmod.com/sourcemod/sourcemodoffsets/issues/1''' <br />

			== Plugin-Making tips ==
			Dumping:
			To get a dump of entity properties specific to empires and similar things, use following commands. <br />
			'''"sm_dump_teprops"''' - Dumps tempentity props to a file <br />
			'''"sm_dump_netprops_xml"''' - Dumps the networkable property table as an XML file <br />
			'''"sm_dump_netprops"''' - Dumps the networkable property table as a text file <br />
			'''"sm_dump_classes"''' - Dumps the class list as a text file <br />
			'''"sm_dump_datamaps"''' - Dumps the data map list as a text file <br />
			'''"sm_dump_admcache"''' - Dumps the admin cache for debugging <br />
			'''"sm_dump_handles"''' - Dumps Handle usage to a file for finding Handle leaks <br />

			Just add a filename after the command and you will find the dump files in empires folder. <br />
			Just using some of those commands might make your client/server hang or even crash, but it will probably still make the dump, or just retry. <br />
			------
			'''Colors for messages:''' <br />
			Custom colors usable by PrintToChat and similar. <br />
			''Examples:'' <br />
			<pre>\x079764FF BE
			\x07FF2323 NF

			PrintToChatAll("\x04[PLUGIN]\x079764FF BE\x01 not ready");
			PrintToChatAll("\x04[PLUGIN]\x01 Commander left\x07FF2323 NF");</pre>

			'''\x07''' - ''Type of coloring/message (custom colors seem to only work with \x07 and \x08)'' <br />
			'''9764FF''' - ''HTML '''RRGGBB''' color without the '''#''' (You can pick your own color for example here: https://www.w3schools.com/colors/colors_picker.asp)'' <br />

			'''Neoony's color standards:''' (Updated 18.4.2017 - Added player name color<br />
			<pre>\x01 for standard text
			\x04 for plugin things (example: "\x04[NCEV]\x01") [green]
			\x079764FF for Brenodi Empire team [eyedropped from chat text]
			\x07FF2323 for Northern Faction team [eyedropped from chat text]
			\x07CB4491 for Both teams [mixed color of BE and NF, somewhat pink]
			\x07CCCCCC for Spectators [gray]
			\x07ff6600 for player name, if you cant use team colors for that [orange]
			\x073399ff for displaying time, mainly seconds [light blue]
			\x07008000 for enabled, unlocked or simply positive [green]
			\x07b30000 for disabled, locked or simply negative, also for warnings [red]</pre>

Thexa4 at 01:53, 10 August 2017

2017-08-10T01:53:51Z

← Older revision		Revision as of 01:53, 10 August 2017
Line 10:		Line 10:
	* Copy the cfg and addons folders to your empires folder		* Copy the cfg and addons folders to your empires folder
	* Install some [[Sourcemod Plugins]]		* Install some [[Sourcemod Plugins]]

			== Developing Plugins ==
			Empires has a lot of [[Game_events_added \| game events]] you can make use of. For an example of plugins you can make see our [https://git.emiresmod.com/sourcemod/ sourcemod repository].

Thexa4: Custom offsets don't work

2017-03-20T16:43:23Z

Custom offsets don't work

← Older revision		Revision as of 16:43, 20 March 2017
Line 9:		Line 9:
	* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable		* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable
	* Copy the cfg and addons folders to your empires folder		* Copy the cfg and addons folders to your empires folder
	* (optional) Install custom offsets
	** Create a folder named custom in the addons/sourcemod/gamedata folder
	** Create a folder named sdkhooks.games in the addons/sourcemod/gamedata/custom folder
	** Find someone with updated offsets or generate them from: https://forums.empiresmod.com/index.php?threads/calculating-updated-sourcemod-vtable-offsets.20571/
	** Place the game.empires.txt in the addons/sourcemod/gamedata/custom/sdkhooks.games folder
	* Install some [[Sourcemod Plugins]]		* Install some [[Sourcemod Plugins]]