Player Filtering under OSP
=============================
rhea@OrangeSmoothie.org
14 Dec 01

OSP最新的相关中文文本信息你可以在http://www.q3acn.com获得，
如果有问题请与cat@q3acn.com联系。


“玩家过滤功能”是osp下的不仅仅通过IP地址来实现玩家的ban，下面会对现有
版本的特点加以描述。

所有过滤命令的格式为：

<ban的命令><TAB><玩家名字><TAB><IP起始地址><TAB><密码>

<ban的命令>:
	banplayer
	bantag
	banaddr
	banpass

<玩家名字>
	被ban和允许的玩家的名字（或名字的一部分）

<IP起始地址>
	被ban/允许的客户端IP的开始部分。
        

<password>
	定义客户端公共“password”或“osp_password”所必须通过/失败现有
	过滤文件的密码。

----> 注意："none"将忽略这个条件。


id名过滤功能
--------------

惯用的名字过滤。这定义正好匹配一玩家名字来允许/拒绝（忽视大小写和颜色定义）

在精确被匹配名字的前提下，客户端只要满足下面条件之一，则仍有可能连入。
        - 满足<address_prefix>规则（如果被设置了）
        - 客户端用户信息中"password"或"osp_password"，满足<password>规则（如果被设置了）

----> 这是常用的ban的方式。这里推荐ban“标记”（下面有介绍）过滤
	方法来实现更多的ban方法。

例子：

banplayer	Rhea	none	none
        --->（没有人可以以Rhea的id连接，或在连接后改名为Rhea）

banplayer	Johnny	129.237.	my_bad
	--->（没有人可以以Johnny的id连接，或在连接后改名为Johnny。但如果
              他的IP开头为129.237.，或他们的"password" 或 "osp_password"为
              "my_bad"时，他仍然可以连入）

id“标记”过滤功能
--------------------

模糊名字匹配过滤方法。该功能可以通过对玩家名字的模糊匹配过滤（不包括大写
和彩色名字）来实现允许/禁止。该功能和精确匹配整个名字的过滤（上面介绍的）
方式最主要的不同是使用了“标记”。它可以阻止玩家通过对名字的细微改动而
逃过ban的过滤。

玩家将永远被拒绝用过滤文件中指定的名字连入服务器（或者是连入后改变成禁止的名字）

客户端的名字如果匹配了指定“标记”则不能连入服务器，除非满足下面两个条件：
	- 符合<IP起始地址>规定（如果定义了）
	- 客户端的"password" 或 "osp_password"符合<密码>规定（如果定义了）

----> 这种方式被推荐使用在几乎所有的ban名字情况下。事实上，也找不到不
	使用的理由=)

例子：

bantag	a|	none	w3rd
	--->（如果id中有a的话，则无法连入，除非他的"password" 或 
		"osp_password"为w3rd）


IP地址过滤功能
--------------------
连入客户端地址的过滤功能。它允许服务器管理者通过客户端的IP地址来
拒绝客户端的连入。如果客户端的IP地址匹配过滤文件中<IP起始地址>，
那他将无法连入服务器，除非满足下面两个条件：
	- 符合<玩家名字>规定（如果指定了）
	- 客户端的"password" 或 "osp_password"符合<密码>规定（如果定义了）

----> 这也许是ban住玩家最根本的方式

例子：
banaddr	none	129.237.	none
	---> （IP开头为129.237的不能连入）

banaddr	none	129.237.	imc00l
	--->（IP开头为129.237的不能连入，除非他的"password" 或 "osp_password"为imc00l


密码过滤功能
--------------------
连入客户端密码过滤功能。它允许服务器管理者指定连入服务器的客户端所
必需的密码。客户端的"password"或"osp_password" 密码必须和服务器设置
的密码一致才能连入，除非其满足下面两个条件：
	- 符合<玩家名字>规定（如果指定了）
	- 符合<IP起始地址>规定（如果定义了）

----> 除非玩家没有通过<玩家名字>、<IP起始地址>（也许根本就没设置
	这两个参数），否则玩家不会被ban住。因此当长时间使用默认密
	码时，最好有一个临时密码。

例子：
banpass	none	129.237.	onthedownlow
	--->（玩家的"password" 或 "osp_password"不为onthedownlow的不能连入
                除非他的IP开头为129.237.




