mirror/blessing-skin-server

Fork 1

mirror of https://github.com/bs-community/blessing-skin-server.git synced 2024-12-21 06:19:38 +08:00

printempw 6fd45b5d70 update README

2016-03-19 20:41:56 +08:00

7.5 KiB

Raw Blame History

Blessing Skin Server

优雅的开源 PHP Minecraft 皮肤站。演示地址

特性：

支持 UniSkinAPI
支持 CustomSkinLoader API
同时支持旧版样式链接
支持与 Authme、CrazyLogin、Discuz 等程序进行数据对接
多种后台配色~
可以获取由用户皮肤生成的头像（example.com/avatar/{{size}}/username.png）

环境要求：

一台支持 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，转载请注明。

7.5 KiB Raw Blame History Unescape Escape