inital commit, setup LFS, README and ignore attributes.

This commit is contained in:
2026-01-07 05:36:20 -05:00
parent 9e23726b74
commit 0ef8419acf
3 changed files with 54 additions and 139 deletions

5
.gitattributes vendored Normal file
View File

@@ -0,0 +1,5 @@
*.psd filter=lfs diff=lfs merge=lfs -text
*.zip filter=lfs diff=lfs merge=lfs -text
*.png filter=lfs diff=lfs merge=lfs -text
*.mp4 filter=lfs diff=lfs merge=lfs -text
*.blend filter=lfs diff=lfs merge=lfs -text

138
.gitignore vendored
View File

@@ -1,138 +1,2 @@
# ---> Node
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
lerna-debug.log*
.pnpm-debug.log*
# Diagnostic reports (https://nodejs.org/api/report.html)
report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
# Runtime data
pids
*.pid
*.seed
*.pid.lock
# Directory for instrumented libs generated by jscoverage/JSCover
lib-cov
# Coverage directory used by tools like istanbul
coverage
*.lcov
# nyc test coverage
.nyc_output
# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
.grunt
# Bower dependency directory (https://bower.io/)
bower_components
# node-waf configuration
.lock-wscript
# Compiled binary addons (https://nodejs.org/api/addons.html)
build/Release
# Dependency directories
node_modules/ node_modules/
jspm_packages/ package-lock.json
# Snowpack dependency directory (https://snowpack.dev/)
web_modules/
# TypeScript cache
*.tsbuildinfo
# Optional npm cache directory
.npm
# Optional eslint cache
.eslintcache
# Optional stylelint cache
.stylelintcache
# Microbundle cache
.rpt2_cache/
.rts2_cache_cjs/
.rts2_cache_es/
.rts2_cache_umd/
# Optional REPL history
.node_repl_history
# Output of 'npm pack'
*.tgz
# Yarn Integrity file
.yarn-integrity
# dotenv environment variable files
.env
.env.development.local
.env.test.local
.env.production.local
.env.local
# parcel-bundler cache (https://parceljs.org/)
.cache
.parcel-cache
# Next.js build output
.next
out
# Nuxt.js build / generate output
.nuxt
dist
# Gatsby files
.cache/
# Comment in the public line in if your project uses Gatsby and not Next.js
# https://nextjs.org/blog/next-9-1#public-directory-support
# public
# vuepress build output
.vuepress/dist
# vuepress v2.x temp and cache directory
.temp
.cache
# vitepress build output
**/.vitepress/dist
# vitepress cache directory
**/.vitepress/cache
# Docusaurus cache and generated files
.docusaurus
# Serverless directories
.serverless/
# FuseBox cache
.fusebox/
# DynamoDB Local files
.dynamodb/
# TernJS port file
.tern-port
# Stores VSCode versions used for testing VSCode extensions
.vscode-test
# yarn v2
.yarn/cache
.yarn/unplugged
.yarn/build-state.yml
.yarn/install-state.gz
.pnp.*

View File

@@ -1,3 +1,49 @@
# assets-vor # Visions Of Reality Assets
A repo to track the assets for the game Visions of Reality ## Structure
- The `src/` directory contains all data related to the assets for the game
- The `tools/boards/` directory contains any LEONARDO whiteboards for prototyping, explaining, etc...
- The `tools/kanban/` directory contains the issues for tracking what assets are done.
## Views
### Local View
Comes into view only when in game, and a user is focused on a grid cell / tile
Sprite models are alawys fixed to 32 square pixels.
Any backgrounds should be a minimum length of 512 pixels and a height of 400
### World View
All entities on the game board will be rendered as voxels fixed to 64 cubic pixels.
### UI View
Sprite models are alawys fixed to 32 square pixels.
### Editors
- MagicaVoxel for any assets that are voxel like, for example World View objects
- 2D sprite editors (Aseprite, Photoshop, figma, etc...) for UI and Local View objects
## Important Notes
The game has an innate combinatorial explosion of possible assets due to the combo system where entities can be represented in one of three tier.
Each tier builds upon the last tier, and the assets should reflect this.
Follow the paradigm of kitbashing, where we create models from pieces of other assets. This way we create a large variaty of choices and can dynamically add them in the game code when a valid combination occurs.
### ENSURE GIT LFS IS INSTALLED
- To install git lfs enter
```bash
git lfs install
```
- If any new file types are added to the project we must track them using the following command...
```bash
git lfs track "*.<extension>"
```