init
Some checks are pending
Sync Github To Image / sync-gitlink (push) Waiting to run
Sync Github To Image / sync-gitlab (push) Waiting to run
Sync Github To Image / sync-gitee (push) Waiting to run
Sync Github To Image / sync-atomgit (push) Waiting to run
Sync Github To Image / sync-gitcode (push) Waiting to run
Sync Github To Image / sync-framagit (push) Waiting to run

This commit is contained in:
陈思海 2025-01-23 10:38:21 +08:00
parent da1d913f21
commit 02672be45a
7 changed files with 108 additions and 25 deletions

View File

@ -1,6 +1,6 @@
MIT License
Copyright (c) 2023 Blank
Copyright (c) 2023 Code Philosophy(代码哲学)
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal

View File

@ -1,3 +0,0 @@
fileFormatVersion: 2
guid: 65ab0fd9d052403ebdaead4404d96767
timeCreated: 1702092259

7
LICENSE.meta Normal file
View File

@ -0,0 +1,7 @@
fileFormatVersion: 2
guid: 078e48d5b430a7d4db6745b56c27f8d5
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:

View File

@ -1,30 +1,49 @@
# 非常强大的配置表解决方案
- [README 中文](./README_zh.md)
- [README English](./README.md)
uban是一个强大、易用、优雅、稳定的游戏配置解决方案。它设计目标为满足从小型到超大型游戏项目的简单到复杂的游戏配置工作流需求。
# Luban
luban可以处理丰富的文件类型支持主流的语言可以生成多种导出格式支持丰富的数据检验功能具有良好的跨平台能力并且生成极快。 luban有清晰优雅的生成管线设计支持良好的模块化和插件化方便开发者进行二次开发。开发者很容易就能将luban适配到自己的配置格式定制出满足项目要求的强大的配置工具。
![icon](docs/images/logo.png)
luban标准化了游戏配置开发工作流可以极大提升策划和程序的工作效率。
该库主要服务于 `https://github.com/GameFrameX/GameFrameX` 作为子库使用。
[![license](http://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT) ![star](https://img.shields.io/github/stars/focus-creative-games/luban?style=flat-square)
# 使用方式(三种方式)
1. 直接在 `manifest.json` 文件中添加以下内容
```json
{"com.gameframex.unity.focus-creative-games.luban": "https://github.com/gameframex/com.gameframex.unity.focus-creative-games.luban.git"}
```
2. 在Unity 的`Packages Manager` 中使用`Git URL` 的方式添加库,地址为https://github.com/gameframex/com.gameframex.unity.focus-creative-games.luban.git
luban is a powerful, easy-to-use, elegant, and stable game configuration solution. It is designed to meet the needs of simple to complex game configuration workflows from small to very large game projects.
3. 直接下载仓库放置到Unity 项目的`Packages` 目录下。会自动加载识别
luban can handle a variety of file types, supports mainstream languages, can generate multiple export formats, supports rich data inspection functions, has good cross-platform capabilities, and generates extremely fast.
Luban has a clear and elegant generation pipeline design, supports good modularization and plug-in, and is convenient for developers to carry out secondary development. Developers can easily adapt luban to their own configuration format, and customize powerful configuration tools that meet project requirements.
# 改动功能
Luban standardizes the game configuration development workflow, which can greatly improve the efficiency of planning and programming.
1. 增加 `Packages` 的支持
2. 移除ODIN 的依赖
3. 增加防裁剪的帮助类。需要在启动的主场景中挂载 `LuBanCroppingHelper` 脚本即可
## Core features
# 使用文档
- Rich source data format. Support excel family (csv, xls, xlsx, xlsm), json, xml, yaml, lua, etc.
- Rich export formats. Support generating binary, json, bson, xml, lua, yaml and other format data
- Enhanced excel format. Simple configurations such as simple lists, substructures, structured lists, and arbitrarily complex deep nested structures can be concisely configured
- Complete type system. Not only can it express common specification line lists, but it can flexibly and elegantly express complex GamePlay data such as behavior trees, skills, plots, and dungeons because **supports OOP type inheritance**
- Support multiple languages. Supports generating language codes such as c#, java, go, cpp, lua, python, typescript, etc.
- Support mainstream message schemes. protobuf(schema + binary + json), flatbuffers(schema + json), msgpack(binary)
- Powerful data verification capability. ref reference check, path resource path, range range check, etc.
- Perfect localization support
- Supports all major game engines and platforms. Support Unity, Unreal, Cocos2x, Godot, WeChat games, etc.
- Good cross-platform capability. It can run well on Win, Linux, and Mac platforms.
- Support all mainstream hot update solutions. hybridclr, ilruntime, {x,t,s}lua, puerts, etc.
- Clear and elegant generation pipeline, it is easy to carry out secondary development on the basis of luban, and customize a configuration tool suitable for your own project style.
https://luban.doc.code-philosophy.com/docs/intro
## Documentation
- [Luban](https://github.com/focus-creative-games/luban)
- [Official Documentation](https://luban.doc.code-philosophy.com/)
- [Quick Start](https://luban.doc.code-philosophy.com/docs/beginner/quickstart)
- **Example Project** ([github](https://github.com/focus-creative-games/luban_examples)) ([gitee](https://gitee.com/focus-creative-games/luban_examples) )
## Support and Contact
- QQ group: 692890842 (Luban development exchange group)
- discord: https://discord.gg/dGY4zzGMJ4
- Email: luban#code-philosophy.com
## license
Luban is licensed under the [MIT](https://github.com/focus-creative-games/luban/blob/main/LICENSE) license

View File

@ -1,3 +1,7 @@
fileFormatVersion: 2
guid: 5c4f345aed3f4bbe89a61e801e26701a
timeCreated: 1702092253
guid: 3cefe9933a4e0e44e845f53b784d2fc6
TextScriptImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:

49
README_zh.md Normal file
View File

@ -0,0 +1,49 @@
- [README 中文](./README_zh.md)
- [README English](./README.md)
# Luban
![icon](docs/images/logo.png)
[![license](http://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT) ![star](https://img.shields.io/github/stars/focus-creative-games/luban?style=flat-square)
luban是一个强大、易用、优雅、稳定的游戏配置解决方案。它设计目标为满足从小型到超大型游戏项目的简单到复杂的游戏配置工作流需求。
luban可以处理丰富的文件类型支持主流的语言可以生成多种导出格式支持丰富的数据检验功能具有良好的跨平台能力并且生成极快。
luban有清晰优雅的生成管线设计支持良好的模块化和插件化方便开发者进行二次开发。开发者很容易就能将luban适配到自己的配置格式定制出满足项目要求的强大的配置工具。
luban标准化了游戏配置开发工作流可以极大提升策划和程序的工作效率。
## 核心特性
- 丰富的源数据格式。支持excel族(csv,xls,xlsx,xlsm)、json、xml、yaml、lua等
- 丰富的导出格式。 支持生成binary、json、bson、xml、lua、yaml等格式数据
- 增强的excel格式。可以简洁地配置出像简单列表、子结构、结构列表以及任意复杂的深层次的嵌套结构
- 完备的类型系统。不仅能表达常见的规范行列表,由于**支持OOP类型继承**能灵活优雅表达行为树、技能、剧情、副本之类复杂GamePlay数据
- 支持多种的语言。支持生成c#、java、go、cpp、lua、python、typescript 等语言代码
- 支持主流的消息方案。 protobuf(schema + binary + json)、flatbuffers(schema + json)、msgpack(binary)
- 强大的数据校验能力。ref引用检查、path资源路径、range范围检查等等
- 完善的本地化支持
- 支持所有主流的游戏引擎和平台。支持Unity、Unreal、Cocos2x、Godot、微信小游戏等
- 良好的跨平台能力。能在Win,Linux,Mac平台良好运行。
- 支持所有主流的热更新方案。hybridclr、ilruntime、{x,t,s}lua、puerts等
- 清晰优雅的生成管线很容易在luban基础上进行二次开发定制出适合自己项目风格的配置工具。
## 文档
- [Luban](https://github.com/focus-creative-games/luban)
- [官方文档](https://luban.doc.code-philosophy.com/)
- [快速上手](https://luban.doc.code-philosophy.com/docs/beginner/quickstart)
- **示例项目** ([github](https://github.com/focus-creative-games/luban_examples)) ([gitee](https://gitee.com/focus-creative-games/luban_examples))
## 支持与联系
- QQ群: 692890842 Luban开发交流群
- discord: https://discord.gg/dGY4zzGMJ4
- 邮箱: luban#code-philosophy.com
## license
Luban is licensed under the [MIT](https://github.com/focus-creative-games/luban/blob/main/LICENSE) license

7
README_zh.md.meta Normal file
View File

@ -0,0 +1,7 @@
fileFormatVersion: 2
guid: a673262afcffe1d4a920ae8401c26bef
TextScriptImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant: