Hello and welcome to Dark Programs 101!
This tutorial is a step by step guide on how to setup and use each program.
Http: is it enabled?
To download programs from pastebin you need http enabled. To do this navigate to your .minecraft/config folder, inside this you will find a file called ComputerCraft.cfg open that up with a text editor such as notepad and navigate to this line:
[b]enableapi_http {[/b]
[b] # Enable the "http" API on Computers[/b]
[b] general=false[/b]
[b]}[/b]
If "general = false" change it to "general = true" This will enable http on your in-game computers.
Note: if you are playing on a server this option might already be enabled, if its not; ask the server owner about it.
Download instructions:
Attach a disk drive to your http enabled pc with a blank floppy in, open your in-game pc and type "pastebin get unzMGFhn downloader" This will download the file from pastebin and save it as a program called "downloader". Next just run the downloader program which will put all the programs onto the disk.
Your installation floppy disk is ready! All you have to do now is place it in a disk drive, reboot the computer and hit the number of the program you want to install.
Computer IDs
Each in-game computer has a unique id, you can find this by typing "id" into the terminal or by placing running the installer disk. These are very important as they are used by programs that use rednet to communicate. Make sure to write down the id of the computer as this is very important for the setup of Dark Programs.
Dark server
The server is the core functionality of all the dark programs, it is used to store disk ids, pc white lists, usernames and passwords. Make sure you write down the ID of the server as it is very important. After installing the server you are presented with a screen saying:
"Dark server running, press 'o' for control panel"
That is "o" as in
orange (this might be changed in future versions)
When you press "o" the server is stopped and the menu screen appears (please remember the server is
stopped whilst the menu screen is running) to leave the menu and run the server press "5" on your keyboard.
Let's do a tour of the GUI!
There are a few options here, ID management, User management, Pc whitelist and Super Pc list. To start with lets add a user, just press "2" on your keyboard to go to the User management sub menu.
The sub menu quite self explanatory, to add a user press "1", type the user's name and press enter, then type the user's password and press enter. Your new user should appear on the screen, and is now added to the list. To delete a user press "2" and type the user's name. Use keys 4 and 5 change the current page. Amount of users and pages are displayed at the bottom right of the screen. To leave the sub menu press "3".
Note: ID managment refers to
disk ids rather than computer ids.
Server white lists are used to allow computers to communicate with the server. The server has two white lists, pc and spc (super pc). Client computers and relays should be added to the pc white list where as card generator computers should be added to the super pc white list. This is important to remember for the rest of the tutorial.
Dark Client
The client is the 2nd most important program in the list as it is need to open doors using keycard or username and passwords. To start with place your computer next to a door with a disk drive and modem attached. Place in your install disk and write down the Clients ID. When you have installed the "client" program onto the computer it will ask for the server ID , type this in and press enter, the setup will then ask you for the side you wish to output redstone, this will be the door's side (top, bottom, left, right, front, back are the options). Finally the setup will ask for the room's label, for example "Smelting room", type in anything you like and press enter. The computer will now restart and now will ask for your username and password to open the door. (you can also put in keycards to open the door on this screen)
If you type in your username and password that you entered into the server now the client will hang and then display "no response from server". You should now go to your server and add the client pc's ID to the pc white list. Now when you type in the user and password, the door should open!
Note: remember rednet has a distance of 60 blocks, your pc could be out of range!
Dark Cardgen
Install the cardgen program on a computer near your server (Remeber to write down the computer's id!) it needs a disk drive and a modem to function. When you have installed the cardgen program it will -like last time- ask for the server's id, type this in and press enter. The cardgen program will now run. Go to your server and add the cardgen computer's id to the "super pc list". This will allow the card gen program to add disk id's into the server's database. All you have to do now is place any disk into the cardgen computers disk drive, it will be spat out. Look at your server it should say that the disk has been added! If you place the disk back into the cardgen computer's disk drive, the disk will be removed from the server's id list. When a disk is on the server's id list it can open any door the username and password can. Place the disk in the client pc's drive and the door should open.
Note: Any disk can be used as a key card
Dark Relay
The relay is only needed if the client computer is out of range of the server. It acts as a bridge betwen the two. All you have to do is setup the relay with the server computer's id. Instead of typing in the server's id on the client type in the relay computer's id. It will forward any message it receives to the server. Multiple relays can be used to make a very large bridge between the client and server computers, they are however a bit insecure and are not recommended for cardgen computers.