The time now is Mon Sep 06, 2010 9:54 am
All times are UTC + 0 |
| Author |
Message |
rockfx01
Join today! ENLIST NOW!

Joined: 23 Oct 2007 Posts: 306 Location: Chicago
|
Posted: Fri Feb 29, 2008 6:00 am Post subject:
Working With the SVN Repository |
|
|
Currently between Agrajag and I, we are getting the SVN Repository up and running. All scripters will need to sign up for an Assembla account and then message their usernames to me so I can add you to the team on Assembla and give you access to the SVN.
What is an SVN Repository?
An SVN Repository is a Subversion control system. Files are stored in a central location, called a repository. Users can access files, download them, edit them, and then upload the changed version to the repository. Unlike a typical file system such as FTP, however, an SVN repository keeps track of all changes that have been made, who made them and when. It allows you to look previous versions of files, create version branches, and more. Subversion can be used to manage any types of files, including scripts.
How Do I Get Started?
1. Sign up for an account on Assembla as mentioned above, and message me your Assembla username so that I can add you to the Fan Made Fallout project on the site.
2. Download and install the TortoiseSVN client on your computer as a shell extension.
3. Go to Start Menu->All Programs->TortoiseSVN->Help and read all of "Chapter 2: Basic Concepts". This will give you an understanding of how the SVN system works and why we are using it.
Setting up Local Working Directories
a. Open Windows Explorer and navigate to the mapper directory, default: C:\Program Files\Black Isle\Fallout 2 Mapper
b. Rename the "scripts" folder "scripts.old". This will act as a backup for the original Fallout scripts if you want to use them as a reference.
c. Create a new folder called "scripts" to replace the old one.
d. Right click the new, empty "scripts" folder and select "SVN Checkout..."
e. in 'URL of repository,' enter the URL:
| Code: | | http://svn2.assembla.com/svn/fmf/scripts |
f. "HEAD revision" should be selected. Click OK.
g. When asked for authentication, supply the username/password combination you use to log in to Assembla.
h. Files will download from the repository to your local working scripts directory, and you will then have the most recent versions of script files in the repository.
i. Navigate to the "C:\Program Files\BlackIsle\Fallout2\" directory.
j. Create a new directory called "data2"
k. Create another directory called "fmfmusic"
l. Right click the "data2" folder and select "SVN Checkout..."
m. in 'URL of repository,' enter the URL:
| Code: | | http://svn2.assembla.com/svn/fmf/data |
n. Follow steps f-h to sync the directory.
o. If desired, make a copy of "fallout2.cfg" called "fallout2.cfg.old".
p. Open "fallout2.cfg" with Wordpad.
q. Overwrite the original entries with the following code:
| Code: | [sound]
music_path1=C:\Program Files\BlackIsle\Fallout2\fmfmusic\
music_path2=D:\data\sound\music\
[system]
critter_dat=C:\Program Files\BlackIsle\Fallout2\critter.dat
critter_patches=C:\Program Files\BlackIsle\Fallout2\data2
master_dat=C:\Program Files\BlackIsle\Fallout2\master.dat
master_patches=C:\Program Files\BlackIsle\Fallout2\data2
art_cache_size=786 |
r. Save and exit Wordpad.
s. Done!
After completing the above steps, you are ready to start working with the most up-to-date repository sources!
Working With the Repository
There are some key items to keep in mind when working with the repository.
1. DO NOT UPLOAD BROKEN SCRIPTS! If you upload an updated script to the repository, everyone will receive your changes with their next sync. This is especially important for header files. If you know some of your changes aren't fully functional yet, please do not upload the scripts until you have fixed the problem. This will keep you from breaking everyone else's scripts too.
2. DO NOT MANUALLY MOVE, RENAME, OR DELETE DIRECTORIES OR FILES! If you manually move files or directories, or rename a file/directory by using standard Windows commands(drag+drop, cut/paste, etc), these changes will not be reflected properly in the Repository.
-2a. File Moves should be done by Right clicking the file/folder and dragging it (with right mouse button held down) to the destination. A menu will pop up where you can select "SVN Move" or "SVN Copy".
-2b. File Renames should be done by Right Clicking the file/folder and going to TortoiseSVN->Rename...
-2c. File Deletes should be done by Right Clicking the file/folder and going to TortoiseSVN->Delete
3. Update your local copy of the SVN often. Do this by right clicking the "Fallout2\data2" and "Fallout 2 Mapper\scripts" directories and selecting "SVN Update".
4. Upload your script files often. This way everyone else will have recent versions of your scripts as well, in case they need to add something to the script as well they can see what you have done to it. Performing regular updates will help keep conflicts to a minimum as well. You can commit a single file or entire folder by right clicking and selecting "SVN Commit...". Before committing a file or folder, verify that it does not break Rule 1.
5. Keep Headers up to date. If you need to make a change to a header, perform an SVN Update of the header(s) you are going to change, make the necessary change(s), and then perform an SVN Commit to commit the change(s) as soon as you have verified the changes have not broken anything (Rule 1).
6. Use naming conventions as outlined in this thread.
6. Please do not perform ANY action if you are unsure of how it should be done. The Help manual should be your first resource in finding out how to do things properly. If you are unsure, please look there thoroughly first. If you cannot figure out how to do something and can't find it in the help manual, feel free to ask me and I will help if I can.
Last edited by rockfx01 on Wed Apr 23, 2008 5:03 pm; edited 2 times in total
|
|
|
Back to top
|
|
 |
rockfx01
Join today! ENLIST NOW!

Joined: 23 Oct 2007 Posts: 306 Location: Chicago
|
Posted: Fri Feb 29, 2008 6:07 am Post subject:
|
|
|
Agrajag hasn't been around much lately, so I just went ahead with making the repository available to everyone. I put his most recent headers, from "HEADERS 02-19-08.rar" in the scripts\headers directory. That's about it.
Anyone working on a script at this point probably has the most current version of it, so please put the files in the proper directories and then Commit them to the SVN so that everyone has access to the scripts.
Some common file paths:
.MSG (dialogue) - \data2\text\english\dialog\
.GAM, .MAP - \data2\maps\
.PRO (protos) - \data2\proto\*Appropriate Directory*\
.INT (compiled scripts) - \data2\scripts\
.SSL - \Fallout 2 Mapper\scripts\*Appropriate Directory*\
.H - \Fallout 2 Mapper\scripts\HEADERS\
There is not currently a location in the repository for .fmf files. These should be kept on the FTP server for now.
_________________ "Sh*t happens. People die. Usually when I'm around."
|
|
|
Back to top
|
|
 |
pjnt
More men and still more are needed!

Joined: 23 Jun 2006 Posts: 1196 Location: Germany
|
Posted: Sun Mar 09, 2008 3:36 pm Post subject:
|
|
|
Signed up user:pjnt
Let's go scripters!!
_________________ And this argument will probably go no further with your "you have to play it before judging it!" reasoning.
|
|
|
Back to top
|
|
 |
rockfx01
Join today! ENLIST NOW!

Joined: 23 Oct 2007 Posts: 306 Location: Chicago
|
Posted: Thu Mar 13, 2008 2:27 am Post subject:
|
|
|
Hey all,
I have added a third base directory to the repository. You can do an SVN Checkout of the folder to any folder on your hard drive you want. It is meant to be used as a temporary storage location for files you are working on, such as dialogue tool files and other files you might want easy access to from a second computer or if you want to easily put a file up for another scripter to look at.
Given the limited space we have on the SVN, please do not use this as a catch-all folder for everything FMF related. That means:
-NO big files
-Delete files from the Temp folder you no longer need there (Right Click the file->Tortoise SVN->Delete).
-Limit the number of revisions of a file you commit to the Temp directory in order to limit the number of SVN revisions that are created by uploading multiple versions of the file. Since this is primarily a 'temporary' location for files, you shouldn't be using it a ton. Most SVN usage should be in the /scripts and /data directories.
Create the local folder you want to use for the directory and do an SVN Checkout of:
| Code: | | http://svn2.assembla.com/svn/fmf/Temp/ |
_________________ "Sh*t happens. People die. Usually when I'm around."
|
|
|
Back to top
|
|
 |
HVAttack8
Don't think about it, join today!

Joined: 22 Nov 2007 Posts: 158 Location: Western New York
|
Posted: Sun Nov 02, 2008 9:44 pm Post subject:
|
|
|
Idk if anyone has said this, but I believe it's also necessary to make those changes from the fallout2.cfg file in the mapper2.cfg file as well.
_________________ I tried to be a mapper, but they said there was no way.
|
|
|
Back to top
|
|
 |
rockfx01
Join today! ENLIST NOW!

Joined: 23 Oct 2007 Posts: 306 Location: Chicago
|
Posted: Wed Feb 25, 2009 10:59 pm Post subject:
|
|
|
Can someone sticky this thread?
K THX BYE.
_________________ "Sh*t happens. People die. Usually when I'm around."
|
|
|
Back to top
|
|
 |
Agrajag
There are some who call me... Tim?

Joined: 16 Aug 2005 Posts: 3238 Location: Sweden
|
Posted: Wed Feb 25, 2009 11:39 pm Post subject:
|
|
|
Stickied!
_________________ I said to Todd Howard: how dumbed down does it get?
Todd Howard hasn't answered yet
But I hear him coughing all night long
A hundred floors below me
In the tower of song
|
|
|
Back to top
|
|
 |
|
|
|
You cannot post new topics in this forum You cannot reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum You cannot attach files in this forum You can download files in this forum
|
Fallout and Fallout 2 are Copyright © 1997, 1998 Interplay Productions, Irvine, California, USA.
Fallout is a trademark of Interplay Productions. All Rights Reserved.

Powered by phpBB © 2001, 2005 phpBB Group
|