admin | ||
assets | ||
includes | ||
libs | ||
templates | ||
user | ||
.gitignore | ||
.htaccess | ||
ajax.php | ||
config.example.php | ||
get.php | ||
index.php | ||
LICENSE | ||
README.md |
Blessing Skin Server
优雅的开源 PHP Minecraft 皮肤站。演示地址
特性:
- 支持 UniSkinAPI
- 支持 CustomSkinLoader API
- 同时支持旧版样式链接
- 支持与 Authme、CrazyLogin、Discuz 等程序进行数据对接
环境要求:
- 一台支持 URL 重写的主机,Nginx、Apache 或 IIS
- PHP 版本 >= 5.4
- 目录的写权限(SAE 等不可写应用引擎的支持正在开发中)
快速使用:
- 下载源码,重命名
config.example.php
为config.php
并配置你的数据库连接信息 - 运行
./admin/install.php
- 如果你是用的是 Nginx,请配置你的
nginx.conf
并加入重写规则 - 注册一个新账户或者使用
安装时所配置的账户
(管理员账户)登录 - 可以上传你的皮肤&披风啦
- 在你所使用的皮肤 Mod 配置文件中加入你的地址
- 完成啦~
服务器配置:
如果你使用 Apache 作为 web 服务器(大部分的虚拟主机),那么恭喜你,我已经帮你把重写规则写好在 .htaccess
里啦,开箱即用,无需任何配置~
如果你使用 Nginx,请在你的 nginx.conf
中加入如下 rewrite 规则**(重要)**:
rewrite ^/([^/]*).json$ /get.php?type=json&uname=$1 last;
rewrite ^/(skin|cape)/([^/-]*)(|-)(|alex|steve).png$ /get.php?type=$1&model=$4&uname=$2 last;
# 以下是可选内容
rewrite ^/(usm|csl)/([^/]*).json$ /get.php?type=json&uname=$2&api=$1 last;
rewrite ^/(usm|csl)/textures/(.*)$ /textures/$2 last;
# 用于获取皮肤头像
rewrite ^/avatar/(|[0-9]*/)([^/-]*).png$ /get.php?type=avatar&uname=$2&size=$1 last;
你可以使用可选的重写规则来同时支持 CustomSkinLoader API 和 UniSkinAPI。如何同时支持会在下面 Mod 配置中说明。
如果你将皮肤站放在子目录中,你需要把重写规则改成类似于这样:
rewrite ^/subdir/([^/]*).json$ /subdir/get.php?type=json&uname=$1 last;
注意 ^/
后和 /get.php
前都要加上你的子目录名。
现在你可以访问 http://example.com/username.json
来得到你的首选 API 的 JSON 用户数据。另外一个 API 的 JSON 数据可以通过访问 http://example.com/(usm|csl)/username.json
得到(需配置可选重写规则)。
上传完皮肤后,你就可以访问 http://example.com/skin/username.png
得到你的首选模型皮肤啦。 披风图片在这里:http://example.com/cape/username.png
。你还可以访问 http://example.com/skin/username-(alex|steve).png
来得到用户的 Alex/Steve 模型的皮肤文件(用户没上传则返回空)。
数据对接:
Blessing Skin Server 支持与 Authme、CrazyLogin、Discuz 等程序进行数据对接,只需在 /admin/options.php
中进行相应配置即可。
如果在插件配置中修改过用户名或者密码的字段,请自行修改 对接数据表用户名字段
等信息。
注意,config.php
中填写的数据库连接信息必须与被对接的程序的连接信息相同(即同一个数据库)。
如需适配其他程序,继承 Database
类并实现 EncryptInterface
与 SyncInterface
两个接口即可。
客户端配置:
CustomSkinLoader 13.1 及以上
CustomSkinLoader 13.1 经过作者的完全重写,支持了 CSL API,并且使用了高端洋气的 JSON 配置文件。
配置文件位于 .minecraft/CustomSkinLoader/CustomSkinLoader.json
,你需要在 loadlist 数组最顶端加入你的皮肤站配置。
举个栗子(原来的 JSON 长这样):
{
"enable": true,
"loadlist": [
{
"name": "Mojang",
"type": "MojangAPI"
},
{
"name": "SkinMe",
"type": "UniSkinAPI",
"root": "http://www.skinme.cc/uniskin/"
}
]
}
你需要将其修改成像这样:
{
"enable": true,
"loadlist": [
{
"name": "YourSkinServer",
"type": "CustomSkinAPI",
"root": "http://example.com/"
},
{
"name": "Mojang",
"type": "MojangAPI"
},
{
"name": "SkinMe",
"type": "UniSkinAPI",
"root": "http://www.skinme.cc/uniskin/"
}
]
}
"type"
字段按照你的 config.php
中配置的首选 API 来填(CustomSkinAPI|UniSkinAPI),CSL 13.1 版是支持三种加载方式的万受♂之王
有什么不会填的,请查看 CSL 开发者的 MCBBS 发布贴。
CustomSkinLoader 13.1 版以下:
在 .minecraft/CustomSkinLoader/skinurls.txt
中添加你的皮肤站地址:
http://example.com/skin/*.png
http://skins.minecraft.net/MinecraftSkins/*.png
http://minecrack.fr.nf/mc/skinsminecrackd/*.png
http://www.skinme.cc/MinecraftSkins/*.png
注意你需要将你的皮肤站地址放在配置文件最上方以优先加载。
同理在 .minecraft/CustomSkinLoader/capeurls.txt
中加入:
http://example.com/cape/*.png
UniSkinMod 1.2 版及以上
在你 MC 客户端的.minecraft/config/UniSkinMod.cfg
中加入你的皮肤站根地址:
举个栗子:
# SkinMe Default
Root: http://www.skinme.cc/uniskin
# Your Server
Root: http://example.com
如果你把皮肤站安装到子目录的话,请一起带上你的子目录。如果你的皮肤站首选 API 为 CustomSkinLoader API 的话,你需要在 UniSkinMod 配置文件中填入类似于 http://example.com/usm
来支持 UniSkinMod。
UniSkinMod 1.2 版以下
同样是在 .minecraft/config/UniSkinMod.cfg
中配置你的皮肤站地址,但是稍有点不一样。旧版的 UniSkinMod 是不支持 Json API 的,而是使用了传统图片链接的方式(其实这样的话皮肤站爷好实现):
举个栗子:
Skin: http://skins.minecraft.net/MinecraftSkins/%s.png
Cape: http://skins.minecraft.net/MinecraftCloaks/%s.png
# Your Server
Skin: http://example.com/skin/%s.png
Cape: http://example.com/cape/%s.png
这是通过 URL 重写(伪静态)实现的,所以皮肤站目录下没有 skin
和 cape
目录也不要惊讶哦。
如果一切都正常工作,你就可以在游戏中看到你的皮肤啦~
常见问题:
访问 example.com/skin/xxx.png
404?
请确认你的伪静态(URL 重写)是否配置正确。
500 错误?
本程序使用了一些 PHP 5.4 的新特性,请确保你的 PHP 版本 >= 5.4
游戏中皮肤不显示?
请先确认你的皮肤站 URL 重写规则已经配置正确,并且可以正常获取皮肤图片。
如果还是不能显示皮肤,请阅读您所使用的皮肤 Mod 的 FAQ。
还是不行的话,请在启动器开启调试模式,并且查看所有关于 skin 的日志, CSL 的日志位于 .minecraft/CustomSkinLoader/CustomSkinLoader.log
。
一般来说看了就可以明白了,如果还是不明白请邮件 联系我(带上你的日志)。
版权:
Blessing Skin Server 程序是基于 GNU General Public License 开放源代码的自由软件,你可以遵照 GPL 协议来修改和重新发布这一程序。
程序原作者为 @printempw,转载请注明。