Psychonic at 22:43, 3 July 2014

2014-07-03T22:43:12Z

Psychonic at 19:04, 24 June 2014

2014-06-24T19:04:08Z

Psychonic: /* Console */

2014-06-24T18:40:15Z

‎Console

Psychonic: Created page with "''This page is a work-in-progress as SourceMod 1.6.0 is not yet released.'' ''These are just the API changes from SourceMod 1.5.3 to SourceMod 1.6.0. Click here for the full..."

2014-06-24T04:34:45Z

Created page with "''This page is a work-in-progress as SourceMod 1.6.0 is not yet released.'' ''These are just the API changes from SourceMod 1.5.3 to SourceMod 1.6.0. Click here for the full..."

New page

''This page is a work-in-progress as SourceMod 1.6.0 is not yet released.''

''These are just the API changes from SourceMod 1.5.3 to SourceMod 1.6.0. Click here for the full [http://wiki.alliedmods.net/SourceMod_1.6.0_Release_Notes SourceMod 1.6.0 Release Notes].''
__FORCETOC__

=Plugins=

==ADT Trie==

While the ADT Trie API has not changed at all, it should be noted that they are no longer backed by actual tries. Instead, they are now backed by hash maps internally.

==Clients==

The following natives no longer require clients to be in-game and now only require them to be connected:
<tt>GetClientDataRate</tt>, <tt>IsClientTimingOut</tt>, <tt>GetClientTime</tt>, <tt>GetClientLatency</tt>, <tt>GetClientAvgLatency</tt>, <tt>GetClientAvgLoss</tt>, <tt>GetClientAvgChoke</tt>, <tt>GetClietnAvgData</tt>, <tt>GetClientAvgPackets</tt>.

==Console==

A new <tt>CommandExists</tt> helper function has been added.

<pawn>/**
* Returns true if the supplied command exists.
*
* @param command Command to find.
* @return True if command is found, false otherwise.
*/
stock bool:CommandExists(const String:command[])</pawn>

==CStrike==

Defines for the <tt>CS_DMG_HEADSHOT</tt> damage flag and <tt>CS_WEAPON_KNIFE</tt> weapon slot have been added.

==DBI==

A new off-thread database transaction API has been added.

Normal usage is to call <tt>SQL_CreateTransaction</tt> to get a transaction handle, and then add queries with <tt>SQL_AddQuery</tt>. You would then call <tt>SQL_ExecuteTransaction</tt> to execute the queries as a batch. If any fail, your <tt>SQLTxnFailure</tt> callback is called, else <tt>SQLTxnSuccess</tt>. You only need to close your transaction handle manually if you do not execute it.

<pawn>/**
* Creates a new transaction object. A transaction object is a list of queries
* that can be sent to the database thread and executed as a single transaction.
*
* @return A transaction handle.
*/
native Handle:SQL_CreateTransaction();</pawn>

<pawn>/**
* Adds a query to a transaction object.
*
* @param txn A transaction handle.
* @param query Query string.
* @param data Extra data value to pass to the final callback.
* @return The index of the query in the transaction's query list.
* @error Invalid transaction handle.
*/
native SQL_AddQuery(Handle:txn, const String:query[], any:data=0);</pawn>

<pawn>/**
* Callback for a successful transaction.
*
* @param db Database handle.
* @param data Data value passed to SQL_ExecuteTransaction().
* @param numQueries Number of queries executed in the transaction.
* @param results An array of Query handle results, one for each of numQueries. They are closed automatically.
* @param queryData An array of each data value passed to SQL_AddQuery().
* @noreturn
*/
functag public SQLTxnSuccess(Handle:db, any:data, numQueries, Handle:results[], any:queryData[]);</pawn>

<pawn>/**
* Callback for a failed transaction.
*
* @param db Database handle.
* @param data Data value passed to SQL_ExecuteTransaction().
* @param numQueries Number of queries executed in the transaction.
* @param error Error message.
* @param failIndex Index of the query that failed, or -1 if something else.
* @param queryData An array of each data value passed to SQL_AddQuery().
* @noreturn
*/
functag public SQLTxnFailure(Handle:db, any:data, numQueries, const String:error[], failIndex, any:queryData[]);</pawn>

<pawn>/**
* Sends a transaction to the database thread. The transaction handle is
* automatically closed. When the transaction completes, the optional
* callback is invoked.
*
* @param db A database handle.
* @param txn A transaction handle.
* @param onSuccess An optional callback to receive a successful transaction.
* @param onError An optional callback to receive an error message.
* @param data An optional value to pass to callbacks.
* @param prio Priority queue to use.
* @noreturn
* @error An invalid handle.
*/
native SQL_ExecuteTransaction(
Handle:db,
Handle:txn,
SQLTxnSuccess:onSuccess=SQLTxnSuccess:-1,
SQLTxnFailure:onError=SQLTxnFailure:-1,
any:data=0,
DBPriority:priority=DBPrio_Normal);</pawn>

==Entity==

The <tt>FindDataMapInfo</tt> native has been added as a complement to the <tt>FindSendPropInfo</tt> native. It retrieves the offset of a given property in an entity's datadesc, supporting nested datadesc tables.

<pawn>/**
* Given an entity, finds a nested datamap property offset.
* This information is cached for future calls.
*
* @param entity Entity index.
* @param prop Property name.
* @param type Optional parameter to store the type.
* @param num_bits Optional parameter to store the number of bits the field
* uses. The bit count will either be 1 (for boolean) or
* divisible by 8 (including 0 if unknown).
* @param local_offset Optional parameter to store the local offset, as
* FindDataMapOffs() would return.
* @return An offset, or -1 on failure.
*/
native FindDataMapInfo(entity,
const String:prop[],
&PropFieldType:type=PropFieldType:0,
&num_bits=0,
&local_offset=0);</pawn>

==Files==

The <tt>FileSize</tt> native now has an optional boolean param to support files in Valve filesystem search paths, similar to the same param on the <tt>FileExists</tt> native.

==Functions==

The <tt>RequestFrame</tt> native has been added for the common case of wanting to run logic exactly one frame in the future. You pass to it a callback, and optionally, one cell of data for context - similar to a timer.

<pawn>/**
* Defines a RequestFrame Callback.
*
* @param data Data passed to the RequestFrame native.
* @noreturn
*/
functag public RequestFrameCallback(any:data);</pawn>

<pawn>/**
* Creates a single use Next Frame hook.
*
* @param Function Function to call on the next frame.
* @param data Value to be passed on the invocation of the Function.
* @noreturn
*/
native RequestFrame(RequestFrameCallback:Function, any:data=0);</pawn>

==Protobuf==

Like CS:GO, Dota 2 also uses protobuf serialized usermessages.

<tt>PbReadInt</tt>, <tt>PbSetInt</tt>, and <tt>PbAddInt</tt> can now be used to read/write protobuf enum values.

A new <tt>PbRemoveRepeatedFieldValue</tt> native has been added to allow removing a value from a protobuf repeated field - the counter to the PbAdd* natives.
<pawn>/**
* Removes a value by index from a protobuf message repeated field.
*
* @param pb protobuf handle.
* @param field Field name.
* @param index Index into repeated field.
* @noreturn
* @error Invalid or incorrect Handle, non-existent field, or incorrect field type.
*/
native PbRemoveRepeatedFieldValue(Handle:pb, const String:field[], index);</pawn>

Lastly, the <tt>PbReadRepeated</tt>* natives that have been deprecated since version 1.5.0 have been completely removed. They only ever existed in 1.5.0-dev versions. The path forward is still to use the PbRead* natives, specified the index of the value you want if it's a repeated field.

==SDKTools==

SDKCalls now support using addresses using either <tt>PrepSDKCall_SetFromConf</tt> with <tt>SDKConf_Address</tt> or, for development purposes, the new <tt>PrepSDKCall_SetAddress</tt> native.

==Testing==

A new, brief testing API has been added for debugging. The Assert* functions will print to the server upon success, and throw an error on failure.

<tt>SetTestContext(const String:context[])

AssertEq(const String:text[], cell1, cell2)

AssertFalse(const String:text[], bool:value)

AssertTrue(const String:text[], bool:value)</tt>

==TF2==

<pawn>/**
* Returns whether or not a holiday is active
*
* @param holiday Holiday being checked.
* @return Boolean of whether or not the holiday is active.
*/
native bool:TF2_IsHolidayActive(TFHoliday:holiday);</pawn>

==TopMenus==

<pawn>/**
* Displays a TopMenu category to a client.
*
* @param topmenu TopMenu Handle.
* @param category Category object id.
* @param client Client index.
* @return True on success, false on failure.
* @error Invalid TopMenu Handle or client not in game.
*/
native bool:DisplayTopMenuCategory(Handle:topmenu, TopMenuObject:category, client);</pawn>

<pawn>/**
* Change the menu title caching behaviour of the TopMenu. By default the titles are cached to reduce overhead.
* If you need dynamic menu titles, which can change everytime the menu is displayed to a user, set this to false.
*
* @param topmenu TopMenu Handle.
* @param cache_titles Cache the menu titles and don't call the handler with TopMenuAction_DisplayTitle everytime the menu is drawn?
* @noreturn
* @error Invalid TopMenu Handle
*/
native SetTopMenuTitleCaching(Handle:topmenu, bool:cache_titles);</pawn>

← Older revision		Revision as of 22:43, 3 July 2014
Line 1:		Line 1:
−	~~''This page is a work-in-progress as SourceMod 1.6.0 is not yet released.''~~
−
	''These are just the API changes from SourceMod 1.5.3 to SourceMod 1.6.0. Click here for the full [http://wiki.alliedmods.net/SourceMod_1.6.0_Release_Notes SourceMod 1.6.0 Release Notes].''		''These are just the API changes from SourceMod 1.5.3 to SourceMod 1.6.0. Click here for the full [http://wiki.alliedmods.net/SourceMod_1.6.0_Release_Notes SourceMod 1.6.0 Release Notes].''
	__FORCETOC__		__FORCETOC__

← Older revision		Revision as of 19:04, 24 June 2014
Line 225:		Line 225:
	*/		*/
	native SetTopMenuTitleCaching(Handle:topmenu, bool:cache_titles);</pawn>		native SetTopMenuTitleCaching(Handle:topmenu, bool:cache_titles);</pawn>
		+
		+	=Extensions=
		+
		+	==IExtensionInterface==
		+
		+	A <tt>OnDependenciesDropped</tt> call has been added for the case noted in the function description.
		+
		+	<cpp>/**
		+	* @brief Called once all dependencies have been unloaded. This is
		+	* called AFTER OnExtensionUnload(), but before the extension library
		+	* has been unloaded. It can be used as an alternate unload hook for
		+	* cases where having no dependent plugins would make shutdown much
		+	* simplier.
		+	*/
		+	virtual void OnDependenciesDropped()
		+	{
		+	}</cpp>
		+
		+	==IGameHelpers==
		+
		+	<tt>FindDataMapInfo</tt> has been added as a replacement to <tt>FindInDataMap</tt> and a companion to <tt>FindSendPropInfo</tt>. It retrieves an sm_datatable_info_t structure that will have the actual offset for the variable, which differs from the offset in the typedescription if data descriptions are nested.
		+
		+	<cpp>/**
		+	* @brief Finds a datamap_t definition.
		+	*
		+	* @param pMap datamap_t pointer.
		+	* @param offset Property name.
		+	* @param pDataTable Buffer to store sm_datatable_info_t data.
		+	* @return typedescription_t pointer on success, NULL
		+	* on failure.
		+	*/
		+	virtual bool FindDataMapInfo(datamap_t pMap, const char offset, sm_datatable_info_t *pDataTable) =0;</cpp>
		+
		+	==IShareSys==
		+
		+	<tt>OverrideNatives</tt> is now deprecated and no longer has any functionality.
		+
		+	==IGamePlayer==
		+
		+	The following two new functions have been added to <tt>IGamePlayer</tt> as retrieved from <tt>IPlayerManager</tt>.
		+	<cpp>/**
		+	* @brief Returns the client's edict/entity index.
		+	*
		+	* @return Client's index.
		+	*/
		+	virtual int GetIndex() const =0;</cpp>
		+
		+	<cpp>/**
		+	* @brief Prints a string to the client console.
		+	*
		+	* @param pMsg String to print.
		+	*/
		+	virtual void PrintToConsole(const char *pMsg) =0;</cpp>
		+
		+	==ILibrarySys==
		+
		+	<cpp>/**
		+	* @brief Retrieve the file component of the given path.
		+	*
		+	* @param buffer Output buffer.
		+	* @param maxlength Length of the output buffer.
		+	* @param path Path to search for a filename.
		+	* @return Number of bytes written to buffer, not including the null terminator.
		+	*/
		+	virtual size_t GetFileFromPath(char buffer, size_t maxlength, const char path) =0;</cpp>

@@ Line 17: / Line 17: @@
 ==Console==
-A new <tt>CommandExists</tt> helper function has been added.
+<tt>OnClientSayCommand</tt> and <tt>OnClientSayCommand_Post</tt> now automatically strip double-quotes from the chat message, either on both sides, or single double-quote on either side. This removes the need for any manual stripping, but may affect some logic already in place.
 <pawn>/**

SourceMod 1.6.0 API Changes - Revision history

Psychonic at 22:43, 3 July 2014

Psychonic at 19:04, 24 June 2014

Psychonic: /* Console */

Psychonic: Created page with "''This page is a work-in-progress as SourceMod 1.6.0 is not yet released.'' ''These are just the API changes from SourceMod 1.5.3 to SourceMod 1.6.0. Click here for the full..."