From 5bf76cb12ca9f7ba06f2856e512917e20d9a95f6 Mon Sep 17 00:00:00 2001 From: thatakkarin Date: Fri, 21 Sep 2012 01:32:00 +0000 Subject: * Added documentation for r16771 (MD5 Hash Check) * Removed sample/npc_sample.txt as it's unneeded (and 17KB of wasted space) * Updated a link in readme/resources.html * Modified readme/commands.html to use doc/atcommands.txt for explanations. git-svn-id: https://rathena.svn.sourceforge.net/svnroot/rathena/trunk@16787 54d463be-8e91-2dee-dedb-b68131a5f0ec --- doc/md5_hashcheck.txt | 44 +++++ doc/sample/npc_sample.txt | 456 ---------------------------------------------- readme/commands.html | 2 +- readme/resources.html | 2 +- 4 files changed, 46 insertions(+), 458 deletions(-) create mode 100644 doc/md5_hashcheck.txt delete mode 100644 doc/sample/npc_sample.txt diff --git a/doc/md5_hashcheck.txt b/doc/md5_hashcheck.txt new file mode 100644 index 000000000..13cda2bb9 --- /dev/null +++ b/doc/md5_hashcheck.txt @@ -0,0 +1,44 @@ +//===== rAthena Documentation ================================ +//= Login Server's MD5 Hash Check +//===== By: ================================================== +//= rAthena Dev Team +//===== Current Version: ===================================== +//= 20120921 +//===== Description: ========================================= +//= This file outlines how the built-in MD5 Hash Check is +//= used and steps enable it. +//============================================================ + +In revision r16771, the login server received an update that allows it to perform +a server-side check of the client to find out it's MD5 hash. This update is an +effort towards ensuring that a user has either: +a.) not been tampered with the client +b.) using the client specific to that particular server + +At present, we know that the client can only send the correct MD5 hash to the server +when using particular server types, so a diff is required to ensure that any client +can send the hash. A link to the required diff plugin for WeeDiffGen can be found at: +http://rathena.org/board/topic/70841-r16771-client-md5-hash-check/ + +Check conf/login_athena.conf for instruction on how to enable it. + +In conf/login_athena.conf you will find the following: +// Client MD5 hash check +// Check client hash? +client_hash_check: off + +This setting simply accepts on or off. + + +// Put your client hashes here, a player can login into the server using +// a hash with a group_id equal or lower the account group_id +// Format: group_id, hash +// Examples: +client_hash: 0, 113e195e6c051bb1cfb12a644bb084c5 +client_hash: 99, cb1ea78023d337c38e8ba5124e2338ae + +Once enabled, you would use those lines to configure this feature (or even as an example). +The group_id can be any of the groups in conf/groups.conf and can be particularly useful +if, for example, you wanted to restrict normal players from dual-clienting and use a lower +number for chat flooding, but wanted to allow dual-clienting and 255 lines before the chat +flood kicks in for your GMs. \ No newline at end of file diff --git a/doc/sample/npc_sample.txt b/doc/sample/npc_sample.txt deleted file mode 100644 index 9dce66094..000000000 --- a/doc/sample/npc_sample.txt +++ /dev/null @@ -1,456 +0,0 @@ -// -// Athena Sample Script -// (c) 2003 Athena Project. -// -// $Id: npc_sample.txt,v 1.1.1.1 2004/09/10 17:26:47 MagicalTux Exp $ - -// このファイルは、Athenaで使用されるスクリプトの解説と使用例のサンプルと -// なっています。 - -// ============= -// *基本的な書式 -// ============= -// \t\t\t -// \tはTABをあらわします。 -// command は "warp" / "monster" / "shop" / "script" のいずれかになります。 -// 各行において"//"以降はコメントとして無視されます。 -// 以下、個々について解説をしていきます。 -// -// 書式中とかかれている部分はnという文字ではなく、任意の文字列/値を示します。 -// また、[n]は必要に応じて指定する任意の文字列/値となっています。 - -// ======== -// *command -// ======== -// -// --------------- -// *通常warp(warp) -// --------------- -// 書式 : ,, warp ,,[],, -// -// - マップデータファイル名。拡張子は必須です。 -// , - ワープポイントの中心座標(x,y) -// - npc名。一文字以上の任意の文字で指定します。ユニークな名前である必要はありません。 -// 実際には表示されません。 -// , - 動作範囲(x,y) を中心に(dx+1,dy+1)の範囲にPCが来ると発動します -// ,, - -// 移動先のマップデータファイル名,座標(x,y) -// destination_gatnameについては拡張子""はあっても無くても構いません。 -// 移動先のmapデータファイルが存在しない(あるいはmap_configで指定されていない)場合は発動しません。 -// 移動先の座標が進入禁止区域であった場合は、ランダムな座標にワープします。 -// また、同一座標に複数のwarpが置かれていた場合、先に記述されているものが有効になります -// これは、confファイル内で指定される、npc*.txtファイルをまたいでwarpを記述するときも同じことがいえます。 -// 例: -prontera,156,185,4 warp sample1 0,0,prontera,156,225 -prontera,156,185,4 warp sample1a 0,0,prontera,156,230 -// sample1の方が先に記述されているので、156,225に移動します -prontera,156,220,4 warp sample1-1 0,0,prontera,156,180 - -// -------------------- -// *モンスター(monster) -// -------------------- -// 書式:,,[,,] monster ,[,,] -// - マップデータファイル名。拡張子は必須です。 -// , - 初期配置座標(x,y) 0,0であればランダムな位置に配置されます。 -// [,,] - 特定範囲内に配置する時に指定します。 -// - マウスカーソルを合わせたときに表示される名前。名前は一文字以上指定してください -// - キャラクター種。詳細についてはお察しください(db/mob_db.txtが参考になると思いますが...) -// - 配置数 -// [,,] - 同一pc_idをもつモンスターの生成時間についての定義 -// 前回出現時間+出現遅延1,倒された時間+出現遅延2,倒された時間+5秒 で算出される値のうち、最も大きい物を -// 出現時間とします -// 例: -prontera,0,0 monster ポリン 1002,5 - -// --------- -// *店(shop) -// --------- -// 書式:,,, shop ,:[,:[,.....:]] -// - マップデータファイル名。拡張子は必須です。 -// , - NPCの配置座標(x,y) -// - npcの向いている方向。0を北(y座標方向+)として、反時計回り45度きざみになっています -// - マウスカーソルを合わせたときに表示される名前。名前は一文字以上指定してください -// - キャラクター種。詳細についてはお察しください -// : - item_id_Nの商品を価格price_Nとして販売物ウインドウに表示します。 -// item_idについてはdb/item_db.txtを参照してください。 -// 例: -prontera,136,203,6 shop 道具商人 73,501:5,502:20,503:55,504:120,506:20,645:80,656:150,601:30,602:30,611:20,610:400 - -// -====================- -// *NPCスクリプト(script) -// -====================- -// 書式: -// ,,, script [,,],{