app/docs/usage/resource_pack.md

title	icon	order	category
资源包	paint-brush	3	使用手册

简介

资源包,也可根据用途称为主题包、字体包、语言包等,它允许你一定程度上自定义轻雪的外观,并且不用修改源码

• 资源/主题商店提供了一些资源包供你选择,你也可以自己制作资源包
• 资源包的制作很简单,如果你接触过Minecraft的资源包,那么你会很快上手
• 部分内容制作需要一点点前端基础,例如html,css,如果你不懂,可以参考一些教程
• 欢迎各位投稿资源包到轻雪资源商店

加载资源包

• 下载的资源包通常是以.zip格式压缩的,你只需要将其解压到根目录resources目录下即可,注意不要嵌套文件夹,正常的路径应该是这样的

main.py
resources
├─resource_pack_1
    ├───metadata.yml
    ├───templates
    └───...
└─resource_pack_2
    ├───metadata.yml
    └───...

• 你自己制作的资源包也应该遵循这个规则,并且应该在metadata.yml中填写一些信息
• 若没有metadata.yml文件,则轻雪不会加载这个资源包

name: "资源包名称"
version: "1.0.0"
description: "资源包描述"
... # 你可以自定义一些信息,但请保证以上三个字段

• 资源包加载遵循一个优先级，即后加载的资源包会覆盖前面的资源包，也就是说，你在A资源包中定义了一个index.html文件，B资源包也定义了一个index.html文件，那么加载B资源包后，A资源包中的index.html文件会被覆盖
• 对于不同资源包的不同文件，是可以相对引用的，例如你在A资源包中的index.html文件中引用了B资源包中的style.css文件，那么加载A资源包后，轻雪会自动加载B资源包中的style.css文件