zhangyuheng/blessing-skin-server
1
0
Fork 0
forked from mirror/blessing-skin-server
Code Pull Requests Activity
89 Commits 9 Branches 89 Tags 22 MiB
PHP 52.8%
TypeScript 40.9%
Twig 5.3%
CSS 0.3%
Dockerfile 0.3%
Other 0.3%
a2758c013a
Go to file
printempw a2758c013a added admin page
2016-02-04 17:21:05 +08:00
admin added admin page 2016-02-04 17:21:05 +08:00
assets added admin page 2016-02-04 17:21:05 +08:00
includes use defined DIR to prevent relative path problem 2016-02-04 17:19:28 +08:00
libs use font Ubuntu 2016-02-03 23:21:35 +08:00
user some style change 2016-02-04 17:20:22 +08:00
.gitignore ignore textures update 2016-01-22 16:05:18 +08:00
ajax.php added password length check 2016-02-03 21:15:29 +08:00
config.php use defined DIR to prevent relative path problem 2016-02-04 17:19:28 +08:00
get.php update install.php to fit new table column last_modified 2016-02-03 13:52:29 +08:00
index.php add link for favicon 2016-02-03 23:06:21 +08:00
LICENSE Initial commit 2016-01-03 14:01:02 +08:00
README.md Update README.md 2016-02-03 16:03:21 +08:00

README.md

Blessing Skin Server

Just a simple open-source Minecraft skin server write in PHP. Live demo

screenshot

Features:

  • Support latest UniSkinAPI
  • Also support legacy link style for UniSkinMod before 1.3
  • Nothing else...

Installation:

  1. Configure your database information in config.php
  2. Run ./admin/install.php
  3. Configure your rewrite rules in your nginx.conf
  4. Register or login with admin/123456
  5. Upload your skin/cape
  6. Configure your url in UniSkinMod.cfg of Minecraft client
  7. Enjoy~

Server configure:

Add rewrite rules to your nginx.conf:

location / {
    rewrite ^/([^/]*).json$ /get.php?type=json&uname=$1 last;
    rewrite ^/(skin|cape)/([^/]*).png$ /get.php?type=$1&uname=$2 last;
}

If you installed the skin server to subdirectory, be careful of your location.

Now you can access http://example.com/username.json to get your json profile. After uploading skins, you can also access http://example.com/skin/username.png for skin image or http://example.com/cape/username.png for cape.

Client configure:

For UniSkinMod version >= 1.3

Put your root directory of skin server( like /path/to/root above ) into your /config/UniSkinMod.cfg of Minecraft client

Sample:

# Line starts with '#' is a commit line
# Line starts with 'Root: ' indicates a server
# All servers will be queried in that order.
# Server in front has higher priority
# Official server has the lowest priority
# No more legacy style link support!

# SkinMe Default
Root: http://www.skinme.cc/uniskin
# Your Server
Root: http://example.com

For UniSkinMod version < 1.3 or other

Also put your url into /config/UniSkinMod.cfg, but you need to fill 2 urls for skin and cape

Sample:

Version: 1
# Do not edit the line above

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

FAQ

If everything works well, you will get an awesome skin in game:

screenshot2

And the log will be like this:

[16:23:56] [launcher/INFO] [UniSkinMod]: Loading configuration ... @D:\Minecraft\1.8\.minecraft\config\UniSkinMod.cfg
[16:23:56] [launcher/INFO] [UniSkinMod]: Root Url Added: http://127.0.0.1/blessing-skin-server

[16:24:23] [Client thread/INFO] [UniSkinMod]: Filling profile for player: 621sama
[16:24:23] [Client thread/INFO] [UniSkinMod]: Fetching URL: http://127.0.0.1/blessing-skin-server/621sama.json
[16:24:23] [Client thread/INFO] [UniSkinMod]: Player Skin Selected: 621sama default 3f14a21723023642b9e8d2bc008b443780698aaedbb7d4e29960e8a2c754a771
[16:24:23] [Client thread/INFO] [UniSkinMod]: Player Cape Selected: 621sama aed8c3fc67aae4906b72fa74c27e15866c89752f0838f6b2a1c44bb4d59cec1e

If not, please check your log to locate where error occured.