Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blockception/bc-minecraft-project
A Typescript library for dealing with minecraft bedrock project data
https://github.com/blockception/bc-minecraft-project
hacktoberfest hacktoberfest2022 minecraft project ts typescript
Last synced: 5 days ago
JSON representation
A Typescript library for dealing with minecraft bedrock project data
- Host: GitHub
- URL: https://github.com/blockception/bc-minecraft-project
- Owner: Blockception
- License: bsd-3-clause
- Created: 2021-05-04T18:52:35.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-06T18:06:12.000Z (10 months ago)
- Last Synced: 2024-04-06T19:23:41.671Z (10 months ago)
- Topics: hacktoberfest, hacktoberfest2022, minecraft, project, ts, typescript
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/bc-minecraft-project
- Size: 497 KB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Blockception Minecraft Project
[](https://github.com/Blockception/BC-Minecraft-Project/actions/workflows/npm-publish.yml)
[](https://github.com/Blockception/BC-Minecraft-Project/actions/workflows/npm-test.yml)
[](https://github.com/Blockception/BC-Minecraft-Project/actions/workflows/tagged-release.yml)
A Typescript library for dealing with minecraft bedrock project data
## Examples
```ts
let project = MCProject.loadSync("some folder");
//First way of getting data
let tags = project.definitions.tag;
if (tags && tags.defined.includes('target')) {
...
}
//Second way of getting data
let tag = MCDefinition.getOrAdd(project.definitions, "tag");
if (tag.defined.includes("target")) {
...
}
//First way of getting project attribute
if (project.attributes.diagnose === "true") {
...
}
//Second way of gettin project attribute
if (MCAttributes.getOrAdd(project.attributes, "diagnose", "false") === "true") {
...
}
```
## Project Attribute
This standard will introduce 3 new file that will help with project definition, attributes, excluded/includes of folders/files and settings that deal
with project for minecraft bedrock.
The file can be found in the root of the project. The following files will be added:
- [Blockception Minecraft Project](#blockception-minecraft-project)
- [Examples](#examples)
- [Project Attribute](#project-attribute)
- [McAttributes](#mcattributes)
- [McDefinitions](#mcdefinitions)
- [McIgnore](#mcignore)
- [Contributing](#contributing)
### McAttributes
The file with the name: `.mcattributes`. This file stores any of the settings or attribtues related to the project. Which uses universal determined
keys along each project. Each tool/program may also introduce each own set of keys, aslong as they are unique to the tool/program. Other
programs/tools simply ignore these keys. But when overwriting the file, must keep the old keys from other tools or programs.
A wider specification can be found in [McAttributes](https://faq.blockception.dev/mcproject/mcattributes)
**Example**
```ini
diagnose=true
diagnose.objectives=true
diagnose.tags=true
diagnose.mcfunctions=true
world.area_used=0 0 0 1000 256 1000
```
---
### McDefinitions
This file specifies anything that is included in the project, but cannot be found in the project files itself, or not easly. At the same time the user
can also blacklist definition through this same project.
A wider specification can be found in [McDefinitions](https://faq.blockception.dev/mcproject/mcdefinitions)
**Example**
```ini
## I am a comment
## Tags used in the map
tag=initialized
tag=calculating
tag=enemy
tag=monster
## Tags to be black listed
tag=!Monster
## Objectives used in the map
objective=var
objective=coin
objective=foo
## Objectives blacklisted
objective=!Var
objective=!Coin
## Families
family=npc
## Families Blacklisted
family=!Npc
## Entity names
name=Steve
## Entity names blacklisted
name=!steve
```
---
### McIgnore
Based upon `.gitignore`. This file specifies through glob-patterns what files, folder to included/excluded from the project.
A wider specification can be found in [McIgnore](https://faq.blockception.dev/mcproject/mcignore)
**Example**
```ini
## This is a comment
## this will ignore the folders/file called Template
Template
## This will included file/folders that are in a folder called template and have the name and extension: settings.json
!Template/settings.json
```
---
## Contributing
First, read the [contributing guide](./CONTRIBUTING.md). fork the project, clone it and run the following commands:
**Installation**
```cmd
npm ci
npm update
```