fenix-tools v0.2.0-b

fenix-tools | FeniX Engine Developer Tools

Welcome to the FeniX Engine Developer Tools repository. Here you will find a modular library built for use with RPG Maker MV plugin development.

Fenix Tools is designed with modern ES6 Javascript and is designed to help with common tasks which occur often when developing plugins for RPG Maker MV.

Tree-shakeable!

When using a bundler like Webpack or Rollup for bundling plugins, you can ensure you get only what you use in your plugin and not the whole library with it. This makes your plugins self reliant and it won't depend on the entire fenix-tools library to be used.

Getting Started

Prerequisites

Skip if you already have NodeJS & npm.

Windows

• Install NodeJS

Ubuntu

• Install NodeJS

sudo apt-get install nodejs

• Install npm

sudo apt-get install npm

Installation

npm install --save fenix-tools

or

Clone the repository git clone https://gitlab.com/FeniXEngineMV/fenix-tools

And use the bundles library from fenix-tools/dist/fenix-tools.js

Usage

Using fenix-tools is a breeze

Notetags And Meta Made Easy

• Quickly retrieve notetags

  • Supports multiline tags <notes></notes> and normal meta tags <meta:value>

    import { getMultiLineTag, getTag, toObject } from 'fenix-tools'

  const myNotes = getMultiLineTag($dataWeapons1.note, 'myTag') const myTagParameters = toObject(myNotes)

  console.log(myTagParameters) // {opt1: value, opt2: value}

File Management

• Preforms file system tasks with ease and peace of mind.

  • Internet deployment uses Ajax and when playing on a local PC, NodeJS is used.

  import { loadJSON } from 'fenix-tools'

// Loads a JSON file and automatically chooses Ajax or Node to perform its task loadJSON('data/high-scores.json') .then(jsonObject => { console.log(jsonObject) }) .catch((err) => console.error(err))

# Want To Contribute ?
It's really easy to get started with Fenix Tools development

#### Forking And Cloning

- [Fork](https://gitlab.com/FeniXEngineMV/fenix-tools/forks/new) the repo to your own account.

- Clone the repository to a directory on your machine

`git clone git@gitlab.com:UserName/plugins.git`

For a basic how-to on cloning read this [Basic git commands](https://docs.gitlab.com/ee/gitlab-basics/command-line-commands.html)


#### Install Required Packages

Once cloned, change to the root directory of the project and open the command line/terminal and install the packages required for FeniX plugin development

`npm install`

Once installation is complete, we use RollupJS to bundle all files.

`npm run build`

The resulting output after bundling is placed in `./dist/` folder.

# Credits

While this is open source and credit is not required, it would be appreciated it you linked to FeniX Engine's website or GitLab repository to show support.

https://fenixenginemv.gitlab.io/

All plugins and tools developed for FeniX engine must retain its license information in the header of all plugins and files and must not be removed.

# Contributing
Please read over the [Contribution Guide](https://gitlab.com/FeniXEngineMV/fenix-tools/blob/dev/CONTRIBUTING.md)

# License
[The MIT License](https://gitlab.com/FeniXEngineMV/fenix-tools/blob/dev/LICENSE.md)