囫囵吞桃的个人博客 Home

如何搭建一个基于PHP的mc皮肤站(仅方法)

#技术笔记 #博客园 #AI润色 #PHP

tb_cau_skin_site

一个基于 PHP 开发的 CustomSkinAPI 皮肤服务器

🔗 项目地址:
tb_cau_skin_site - Gitee


项目简介

tb_cau_skin_site 是一个基于 PHP + MySQL 编写的 Minecraft 换肤站,
实现了对 CustomSkinAPI 的支持,可配合 CustomSkinLoader(CSL) 模组使用。

特点:

  • 支持上传与管理皮肤

  • 响应 CustomSkinLoader 的 API 请求

  • 仅依赖客户端模组

  • 与服务端无关,兼容性较广

  • 皮肤展示使用开源项目 MineRender API

本文仅介绍如何部署与使用本项目,不涉及具体开发思路。
若反响较好,后续将补充开发过程与设计说明。


免责声明

  • 本项目开发过程中大量使用 AI 辅助

  • 作者水平有限,代码可能存在漏洞或不完善之处

  • 仅供学习与参考使用

  • 因使用本项目造成的任何损失,作者不承担责任

欢迎批评与建议。


当前已知问题

  • 披风(Cape)预览存在异常

部署方法

1️⃣ 环境准备

需要部署:

  • PHP

  • MySQL

  • Apache(或其他支持 PHP 的 Web 服务)

若尚未部署,可参考项目仓库中的 部署php.md 文档。


2️⃣ 创建数据库表

在 MySQL 中创建表 mc_skin_con

字段如下(按顺序创建):

CREATE TABLE mc_skin_con (     id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,     username VARCHAR(50) NOT NULL,     changeCode VARCHAR(50) NOT NULL,     skins_default VARCHAR(350),     skins_slim VARCHAR(281),     skins_cape VARCHAR(281),     skins_elytra VARCHAR(281) );

3️⃣ 配置项目

进入项目目录:

server_config/

按提示修改:

config.php

填写数据库连接信息等配置。


4️⃣ 部署网站

将项目文件上传到服务器 PHP 站点目录。

访问:

http://服务器IP或域名/tb_cau_skin_site/index.php

即可打开皮肤站页面。


在 CustomSkinLoader 中使用

1️⃣ 安装 CSL

安装 CustomSkinLoader 模组。

首次启动游戏后,会在游戏目录生成:

CustomSkinLoader/CustomSkinLoader.json


2️⃣ 修改配置文件

打开 CustomSkinLoader.json,找到 loadlist 字段,添加:

{ "name": "你的皮肤站名称", "type": "CustomSkinAPI", "root": "http://服务器IP或域名/tb_cau_skin_site/" }

⚠ 建议:

  • 将此项放在最前面

  • 如希望仅使用本皮肤站,可删除其他配置项


CSL 下载地址

CustomSkinLoader - MC百科