app/docs/usage/resource_pack.md

37 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: 资源包
icon: comment
order: 3
category: 使用手册
---
## 简介
资源包,也可根据用途称为主题包、字体包、语言包等,它允许你一定程度上自定义轻雪的外观,并且不用修改源码
- 资源/主题商店提供了一些资源包供你选择,你也可以自己制作资源包
- 资源包的制作很简单,如果你接触过`Minecraft`的资源包,那么你会很快上手
- 部分内容制作需要一点点前端基础,例如`html`,`css`,如果你不懂,可以参考一些教程
- 欢迎各位投稿资源包到轻雪资源商店
## 加载资源包
- 下载的资源包通常是以`.zip`格式压缩的,你只需要将其解压到根目录`resources`目录下即可,注意不要嵌套文件夹,正常的路径应该是这样的
```shell
main.py
resources
├─resource_pack_1
├───metadata.yml
├───templates
└───...
└─resource_pack_2
├───metadata.yml
└───...
```
- 你自己制作的资源包也应该遵循这个规则,并且应该在`metadata.yml`中填写一些信息
- 若没有`metadata.yml`文件,则轻雪不会加载这个资源包
```yaml
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`文件