Edit the Non Editable

For doing this, you will need a tool. jhorology made one and it is available at github. Since it might not be everybodies cup of tea, here an effort to make a sort of tutorial for using it. The manual is based on using a Mac. Sorry, I don't use Windows, so I can't make a manual for windows. But it might still contain useful information.

You can also edit an NKS file directly, using an HEX editor. This is a bit cumbersome. For example, Christos Adamos shared a document describing how Controller pages can be reordered. Mind that depending on your OS or used HEX editor, the symbols can be different.

Installation (Mac)

• install node.js and npm (https://www.npmjs.com/get-npm)
• install gulp globally via Terminal: sudo npm install --global gulp-cli

Preparations:

• Create a directory (for instance NKSEdit)
• Create in the directory a regular text file: gulpfile.coffee.
• Add the lines below and change settings to your preference

gulp = require 'gulp'

rewrite = require 'gulp-nks-rewrite-meta'

beautify = require 'js-beautify'

gulp.task 'print-src-presets', ->

gulp.src ["src/**/*.nksf"]

.pipe rewrite (file, metadata) ->

console.info beautify (JSON.stringify metadata), indent_size: 2

undefined

gulp.task 'rewrite-metadata', ->

gulp.src ["src/**/*.nksf"]

.pipe rewrite

author: 'PJP'

bankchain: ['UVI Workstation', 'Digital Synsations', 'DS90s']

.pipe gulp.dest 'dist'

gulp.task 'print-dist-presets', ->

gulp.src ["dist/**/*.nksf"]

.pipe rewrite (file, metadata) ->

console.info beautify (JSON.stringify metadata), indent_size: 2

undefined

Edit the NKS files

• Create within the same directory a subdirectory src and place the original nksf files that. From all files a modified copy will be made with the settings from gulpfile.coffee.
• To create the modified nksf files do the following:
  1. Change settings to your likings in gulpfile.coffee
  2. Open the Terminal and cd to the created directory (containing the gulpfile.coffee)
  3. Now use the following command in Terminal to change the metadata:
  • gulp rewrite-metadata # rewrite metadata

The modified files are located in the dist folder.

Some other commands

To show the metadata of the original files, use the following command in the Terminal:

• gulp print-src-presets # print metadata

To show metadata of the changed copies, use the following command in the Terminal:

• gulp gulp print-dist-presets # print all metadata