OAC:Project: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "[[Image:" to "[[File:")
 
(67 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Image:Banner biki.jpg]]
[[File:Banner biki.jpg]]


by the [[OAC:Project#OAC_Project_Team|OAC Project Team]]
by the [[OAC:Project#OAC_Project_Team|OAC Project Team]]
Line 5: Line 5:




==Project info==
== Project info ==
Welcome to the OAC project - OFP ArmA Conversion.<br>
Welcome to the OAC project - namely OFP ArmA Conversion.<br>
<br>
<br>


== Purpose of the OAC project ==


* '''Playable content'''. Now. Much. Enjoyable. Good quality.
* In the form of: Get any '''OFP missions or campaigns playable in ArmA''' with little or no<br>modification of the mission file.
* '''Possibility to use community made addons alongside''' to improve the visual aspects,<br>sounds or gameplay.
* '''Easy access''' to the content.
* '''Automated''' update and delivery system.
* '''Open system''', focus on '''compatibility''' with community addons and MODs.
* '''Open source project''' - every can contribute very easily.
== NOT the purpose ==
* Make custom models, textures, sounds.
* Convert (OFP) models to ArmA.
* Change the gameplay itself.


==Hosted by==


===Page===
== Cooperation ==
hosted by [http://www.armaholic.com/ armaholic]: [http://oac.armaholic.eu/page OAC project page] made by '''Raptor'''<br>


===Forum===
=== CWR MOD ===
hosted by by [http://www.armaholic.com/ armaholic]: [http://oac.armaholic.eu/forum OAC forum] setup by '''Raptor'''<br>


===FTP===
The goal from [[CWR]] is to recreate the whole OFP CWC experience, based on OFP elite XBOX version.<br>
hosted by [http://www.wglcti.com/ wglcti.com]


===SVN===
Project OAC is '''fully compatible''' to CWR and OAC makes it possible to run
hosted by [http://www.assembla.com/ assembla.com]
any OFP mission with CWR.<br>So OAC can act as an supplement to CWR.<br>
Project OAC uses plain ArmA as a base for models, sounds and graphics.<br>


===Bugtracker===
CWR and OAC are '''sharing their development progress''' on the CWC and RES campaign.<br>
[http://www.mantisbt.org/ mantis] hosted by [http://6thsense.eu/ 6thsense]: [http://oac.6thsense.eu/mantis/ OAC bugtracker]
In addition to that both '''work closely together on the config part''' to ensure full compatibility.<br>


===Build scripts===
Up until today the major difference between both is that OAC is aiming for '''open development''', '''easy'''<br>
hosted by MISSING
'''contribution''' and '''iterative development''' with '''as many releases as possible''' whereas CWR relies on '''few'''<br>'''releases''' to ensure '''top quality''' from the start.


===YomaTools===
hosted by [http://www.quest-link.net quest-link.net]


== Open source project ==


===Our earnest thanks===
The basic idea is that everything is '''easily accessible for anyone'''.


to
In extension to that anyone interested can '''contribute in different ways''' to the project.


* '''[http://www.armaholic.com/ armaholic] team''' for hosting our page and projects!
For example by
* '''[http://www.wglcti.com/ russin ]''' for hosting the OAC FTP server!
* improving this wiki page
* '''[http://6thsense.eu/ Sickboy and the 6thSense community]''' for hosting the OAC mantis!
* reporting bugs on the missions or the addons
* '''[http://www.quest-link.net/ MadDogX]''' for hosting the OAC YomaTools server!
* try new missions and see if they mission file needs to be updated
* '''[http://www.yomatools.be/index.php?option=com_contact&Itemid=3 Yoma]''' for ongoing development and support of [http://yomatools.be/ YomaTools]!
* convert missions themselves and add them to the public hub
* '''Raptor''' for designing the excellent OAC project page, OAC banner and setting up the OAC forum!
* improve the compatibility addon yourself by adding new class mappings of yet missing<br>OFP addons or MODs.<br>
* '''stun''' for play testing the CWC campaign and many fixing issues in the process!
 
To support this process the project heavily relies on '''tools that support collaboration'''.<br>
 
The '''wiki''', '''git''', '''automated build scripts''' and '''Yoma Addon Sync''' for project and mission delivery.<br>
 
Only a '''very loose organization''' will '''keep the project on track''' and ensure the<br>
'''quality''' and '''success''' of the project.<br>


==Purpose of this project==


* '''Playable content'''. Now. Much. Enjoyable. Good quality.
'''So overall it will be an easy access and easy to contribute focus to deliver<br>
* In the form of: Get any '''OFP missions or campaigns playable in ArmA''' with little or no<br>modification of the mission file.
content as easily and as much as possible!'''<br>
* '''Possibility to use community made addons alongside''' to improve the visual aspects,<br>sounds or gameplay.
* '''Easy access''' to the content.
* '''Automated''' update and delivery system.
* '''Open system''', focus on '''compatibility''' with community addons and MODs.
* '''Open source project''' - every can contribute very easily.


==NOT the purpose==


* Make custom models, textures, sounds.
== Support OAC ==
* Change the gameplay itself.


==Relation to CWR==
OAC is an open project that invites you and anybody to contribute.
Here is a brief overview of possible ways:


The goal from [[CWR]] is to recreate the whole OFP CWC experience.<br>
* Promotion screenshots.
* Promotion trailers.
* Campaign testing.
* Mission makers polishing conversions.
* Improve the compatibility addon.
* Convert campaign and missions.


The OAC project will be '''compatible''' to CWR and if it makes it possible to run
See the contact area, if you need advice.
any OFP mission with CWR.<br>So OAC can act as an supplement to CWR.<br>
Project OAC uses plain ArmA as a base for models, sounds and graphics.<br>


CWR and OAC will '''share their development progress''' of the CWC single player campaign.<br>
In addition to that both will '''work closely together on the config part''' to ensure full compatibility.<br>


Up until today the major difference between both is that OAC is aiming for '''open development''', '''easy'''<br>
== How does it work ==
'''contribution''' and '''iterative development''' with '''as many releases as possible''' whereas CWR relies on '''few'''<br>'''releases''' to ensure '''top quality''' from the start.


==How does it work==
{{Feature|important|''Technical details - skip if not interested.''}}


You '''cannot run OFP missions or campaigns in ArmA''' for a few technical reasons.<br>
You '''cannot run OFP missions or campaigns out of the box in ArmA''' for a few technical reasons.<br>
Actually it is quite simple to solve these.
Actually it is quite simple to solve these.


Line 111: Line 121:
fair scripter.<br>
fair scripter.<br>


More technical details below.
== The seven roads to OAC ==
 
==Open source project==
 
The basic idea is that everything is '''easily accessible for anyone'''.
 
In extension to that anyone interested can '''contribute in different ways''' to the project.


For example by
Please always refer to the [[OAC:FAQ|FAQ]] first in case of questions and unclear parts.
* improving this wiki page
* reporting bugs on the missions or the addons
* try new missions and see if they mission file needs to be updated
* convert missions themselves and add them to the public hub
* improve the compatibility addon yourself by adding new class mappings of yet missing<br>OFP addons or MODs.<br>
 
To support this process the project heavily relies on '''tools that support collaboration'''.<br>
 
The '''wiki''', '''SVN''', '''automated build scripts''' and '''YomaTools''' for project and mission delivery.<br>
 
Only a '''very loose organization''' will '''keep the project on track''' and ensure the<br>
'''quality''' and '''success''' of the project.<br>
 
 
'''So overall it will be an easy access and easy to contribute focus to deliver<br>
content as easily and as much as possible!'''<br>


==The seven roads to OAC==


===# I. Consumer===
=== # I. Consumer ===


Not meant in a negative way. Simply plays the missions and campaigns provided.<br>
Not meant in a negative way. Simply plays the missions and campaigns provided.<br>
Silent epicure.<br>
Silent epicure.<br>


[[OAC:Project#.23_I._Download_and_play|Details: Download and play.]]
[[OAC:DownloadAndPlay|Details: Download and play]].




===# II. Promoter===
=== # II. Promoter ===


Tells his mates or other people about the project. Given he likes it of course. :)
Tells his mates or other people about the project. Given he likes it of course. :)


[[OAC:Project#.23_II._Tells_us_about_promotions|Details: Tells us about promotions.]]
[[OAC:PromoteOACandTellUsAboutIt|Details: Promote OAC and tell us about it]].
 


===# III. Feedback===
=== # III. Feedback ===


Shares his opinion about the project.<br>
Shares his opinion about the project.<br>
Line 161: Line 147:
Suggests OFP addons or MODs to be included in the compatibility addon.<br>
Suggests OFP addons or MODs to be included in the compatibility addon.<br>


[[OAC:Project#.23_III._Where_to_post_feedback|Details: Where to post feedback.]]
[[OAC:WhereToPostFeedback|Details: Where to post feedback]].




===# IV. Bugreporting===
=== # IV. Bugreporting ===


Reports bugs in converted missions or campaigns or bugs in the compatibility<br>
Reports bugs in converted missions or campaigns or bugs in the compatibility<br>
Line 170: Line 156:
error, screenshots/videos of the problem).<br>
error, screenshots/videos of the problem).<br>


[[OAC:Project#.23_IV._Where_to_post_bugs|Details: Where to post bugs.]]
[[OAC:WhereToPostBugs|Details: Where to post bugs]].


===# V. Contributer===
 
=== # V. Contributer ===


Helps to improve the wiki page.<br>
Helps to improve the wiki page.<br>
Makes screenshots or videos to promote the project.<br>
Makes screenshots or videos to promote the project.<br>
Helps maintaining the infrastructure of the project (SVN, build process,<br>
Helps maintaining the infrastructure of the project (source repository, build process, YAS server, issuetracker).<br>
YomaTools, bug-tracker).<br>
Supports the project with infrastructure.<br>
Supports the project with infrastructure (SVN server host, YomaTools server host,<br>
bug-tracker host, hosts a mailing list, hosts the project page).<br>
 
[[OAC:Project#.23_V._How_to_contribute|Details: How to contribute.]]


[[OAC:HowToContribute|Details: How to contribute]].


===# VI. Missions converter===
=== # VI. Missions converter ===


Either you help to improve already converted missions or campaigns by fixing bugs<br>
Either you help to improve already converted missions or campaigns by fixing bugs<br>
Line 190: Line 174:
Or you convert new missions or campaigns yourself and add them to the public sharing system.<br>
Or you convert new missions or campaigns yourself and add them to the public sharing system.<br>


[[OAC:Project#.23_VI._How_to_convert_missions_and_share|Details: How to convert missions and share.]]
[[OAC:HowToConvertMissionsAndShare|Details: How to convert missions and share]].




===# VII. Core developer===
=== # VII. Core developer ===


You are already into config editing or want to learn something about it.<br>
You are already into config editing or want to learn something about it.<br>
Line 201: Line 185:




[[OAC:Project#.23_VII._How_to_improve_the_compatibility_addon|Details: How to improve the compatibility addon.]]
[[OAC:HowToImproveTheCompatibilityAddon|Details: How to improve the compatibility addon]].




=== Subpage link overview ===


==The seven roads to OAC - details==
* [[OAC:DownloadAndPlay|I. Download and play]]
** [[OAC:DownloadAndPlay#Update_OAC|Update OAC]]
** [[OAC:DownloadAndPlay#Replacement_addons|Replacement addons]]
** [[OAC:DownloadAndPlay#Play_OAC_with_CWR|Play OAC with CWR]]
* [[OAC:TellsUsAboutPromotions|II. Tell us about promotions]]
* [[OAC:WhereToPostFeedback|III. Where to post feedback]]
* [[OAC:WhereToPostBugs|IV. Where to post bugs]]
* [[OAC:HowToContribute|V. How to contribute]]
* [[OAC:HowToConvertMissionsAndShare|VI. How to convert missions and share]]
* [[OAC:HowToImproveTheCompatibilityAddon|VII. How to improve the compatibility]]


===# I. Download and play===
== Our earnest thanks ==
The OAC files are now available via '''YomaTools''' (Yoma Arma Addon Synchroniser).


First please download the newstest version of Yoma tools at '''http://yomatools.be'''.<br>
to our hosts:
Hint: You find the download in the left navigationbar.


Once you have downloaded and installed YomaTools, add a '''new server''' with following data:
* {{Link|http://oac.armaholic.eu/page|Page}} hosted by {{Link|link= http://www.armaholic.com/|text= armaholic}}: made by '''Raptor'''.
* {{Link|link= http://dev-heaven.net/projects/oac/boards|text= Forum}} hosted by {{Link|http://dev-heaven.net|dev-heaven.net}}.
* {{Link|link= http://dev-heaven.net/repositories/show/oac|text= Source repository}} hosted by {{Link|http://dev-heaven.net|dev-heaven.net}}.
* {{Link|link= http://dev-heaven.net/projects/oac/issues|text= Issue tracker}} {{Link|http://www.redmine.org/|Redmine}} hosted by {{Link|http://dev-heaven.net|dev-heaven.net}}.
* {{Link|link= http://dev-heaven.net/projects/show/yoma-addonsync2009|text= Yoma Addon Sync 2009}} hosted by {{Link|http://www.quest-link.net|quest-link.net}}.


'''Server name: OAC Project'''
to individuals


'''Server url: http://oac.quest-link.net/updater'''
* '''{{Link|link= http://www.armaholic.com/plug.php?e=team|text= armaholic team}}''' for hosting our page and projects!
 
* '''{{Link|http://dev-heaven.net|Sickboy}}''' for hosting OAC @ dev-heaven.net!
Press '''Download all mods''' to get all files, missions and campaigns (large
* '''{{Link|http://www.quest-link.net/|MadDogX}}''' for hosting the OAC YAS server!
button on the lower right).<br>
* '''{{Link|http://www.yomatools.be/index.php?option{{=}}com_contact&Itemid=3|Yoma}}''' for ongoing development and support of {{Link|link= http://dev-heaven.net/projects/show/yoma-addonsync2009|text= Yoma Addon Sync}}!
 
* '''Raptor''' for designing the excellent OAC project page, OAC banner and setting up the OAC forum!
You can also have a look at the different packages by clicking on in the<br>
* '''The-f''' for the ACEIP island conversion!
respective line and de-/select the files of your interest.<br>
* '''stun''' for play testing the CWC campaign and many fixing issues in the process!
 
* '''Mopar''' for campaign testing, his campaign & mission conversions!
Required packages to run OAC:
* '''luemmel''' for campaign testing, promotion and his mission conversions!
 
* '''Snake Man''' for his campaign & mission conversions!
* @ace_islands\addons
* '''SLAYER RF''' for his p85 replacement configs!
* @oac\addons
* dta\userconfig
* dta\userconfig\ace_island_config
 
 
====Detailed process description====
 
'''Here is a step by step guide.'''
 
Please head over to the [http://oac.armaholic.eu/forum/index.php OAC forum] if questions remain.
 
 
 
<br clear="all" />
[[Image:Startup.jpg|thumb|600 px|Startup|left]]
<br clear="all" />
 
1. Start YomaTools.
 
<br clear="all" />
[[Image:Servername.jpg|thumb|600 px|Servername|left]]
<br clear="all" />
 
2. For '''Server name''' insert: '''OAC Project'''.
 
<br clear="all" />
[[Image:Serverurl.jpg|thumb|600 px|Serverurl|left]]
<br clear="all" />
 
3. For '''Addon Server URL''' insert: '''http://oac.quest-link.net/updater'''.
 
<br clear="all" />
[[Image:Save_server.jpg|thumb|600 px|Save_server|left]]
<br clear="all" />
 
4. Now save the server settings on the '''save''' button.
 
<br clear="all" />
[[Image:Serverlist.jpg|thumb|600 px|Serverlist|left]]
<br clear="all" />
 
5. The '''OAC Project''' server is now available in the list box at the top.
 
<br clear="all" />
[[Image:Settings.jpg|thumb|600 px|Settings|left]]
<br clear="all" />
 
6. Next you should check '''Settings''' to verify if it found your ArmA directory.<br>
Normally this works automatically.
 
<br clear="all" />
[[Image:Mod_addon_list.jpg|thumb|600 px|Mod_addon_list|left]]
<br clear="all" />
 
7. Now you should select the '''OAC Project''' server from the server list.<br>
You will see all '''packages''' from the '''OAC Project''' server in the large list box below.<br>
 
<br clear="all" />
[[Image:Download.jpg|thumb|600 px|Download|left]]
<br clear="all" />
 
8. The last step is to click on the '''Download all mods''' button.<br>
YomaTools will automatically download all files from the server to your ArmA folder and create the mod folders.
 
{{Important|Do NOT forgot to load all the mod folders. YomaTools can do that for you in the '''Launch Game''' tab.}}
 
{{Important|Note that you need to download a few addons yourself, if you want to use the '''@oac-optional-unit-replacement'''.}}
 
===# II. Tells us about promotions===
 
Best point your friends and other community member to the [http://community.bistudio.com/wiki?title=OAC:Project OAC BIKI page].<br>
Good supplements are the [http://www.proper.armaholic.eu/download/oac OAC page] and the [http://www.flashpoint1985.com/cgi-bin/ikonboard311/ikonboard.cgi?act=ST&f=69&t=74341&st=0 OAC thread] in the BI forum.
 
Please always add these three sources to threads and news posts.
 
'''A request to news writers''':<br>
Please add news about OAC at your page to his section for us to know so that<br>
we can help with questions and gather feedback from the comments.
 
'''Thank you!'''
 
News and threads about OAC:<br>
[http://www.link.missing LINK MISSING]<br>
 
===# III. Where to post feedback===
 
The [http://www.flashpoint1985.com/cgi-bin/ikonboard311/ikonboard.cgi?act=ST;f=69;t=74341;st=0 OAC BI forum thread] is the the best place to share your thoughts and suggestions about the project itself.
 
 
For bugreporting or suggesting new content to be made compatible the [http://oac.6thsense.eu/mantis/main_page.php OAC bugtracker] it the best place:
 
* '''Suggestion for mission conversions''' will be gathered '''ONLY''' on this [http://oac.6thsense.eu/mantis/view.php?id=2 ticket].
 
* '''Suggestion for campaign conversions''' will be gathered '''ONLY''' on this [http://oac.6thsense.eu/mantis/view.php?id=3 ticket].


* '''Suggestion about addons or MODs to be included''' in the compatibility addons will<br>be gathered '''ONLY''' on this [http://oac.6thsense.eu/mantis/view.php?id=1 ticket].


===# IV. Where to post bugs===
== Project team ==
 
Please post bugs related to OAC project only at the [http://oac.6thsense.eu/mantis/ OAC bugtracker].<br>
 
The problems can be:
 
* Non working missions or campaigns
* Problems with the installation
* Problems with the updating
 
Please keep your bug reports '''as specific and as precise as possible'''.<br>
Adding '''screenshots''', '''videos''' or the errors from the [[arma.RPT]] help to visualize
the problem.<br>
 
A rough description of the '''steps to reproduce''' or the '''mission and its savegame'''<br>
are another good addition to track the problem down.
 
Recommended tools for recording:
 
* [http://www.planetgamecam.com/?locid=download GameCam]
* [http://www.fraps.com/download.php Fraps]
* [http://www.howiesfunware.com/loadSideBarMiscSoftware.html Howie's Quick Screen Capture Tool]
 
===# V. How to contribute===
 
 
===# VI. How to convert missions and share===
 
 
===# VII. How to improve the compatibility addon===
 
====Setup the development====
 
Project OAC uses [http://en.wikipedia.org/wiki/Subversion_%28software%29 subversion] (SVN) as sort of file sharing tool for the development.
 
You can download the '''compatibility addon''' in source format with SVN, improve the existing code<br>
or add new class mappings in there and upload (commit) your changes again for everyone to use<br>
and improve.
 
'''1.''' You are recommended to [http://tortoisesvn.net/downloads download TortoiseSVN] as windows SVN client with an excellent GUI:
* [http://tortoisesvn.tigris.org/ExplorerIntegration.html#contextmenus Windows explorer integration]: Update your local SVN files easily.
* [http://tortoisesvn.tigris.org/commitdialog.html Powerful commit dialog]: Upload dialog to share your changes and tell people what you did.
* [http://tortoisesvn.tigris.org/TortoiseMerge.html TortoiseMerge]: Check your local changes or incoming changes by other people.
 
'''2.''' Install TortoiseSVN and restart windows.
 
'''3.''' Create a new MF (modfolder) named @OAC in your ArmA installation, like .\ArmA\@OAC\addons.
 
'''4.''' RMB (Right mouse button) click on the [http://www.proper.armaholic.eu/download/oac/images/oac_svn_checkout_dialog.jpg addons folder and select 'SVN Checkout'] [[Image:Image icon.png|20 px]].
 
'''5.''' In the [http://www.proper.armaholic.eu/download/oac/images/oac_svn_checkout_details.jpg checkout dialog] [[Image:Image icon.png|20 px]] copy the following URL in the dialog as 'URL to repository (server)':<br>
 
http://svn.assembla.com/svn/project-oac/addons/ofp_compatibility_addon
 
Make sure to have the same folder structure inside your ArmA folder, like
 
.\ArmA\@OAC\addons\ofp_compatibility_addon
 
You can name the MF (modfolder) different to @OAC though.
 
Hit OK once you are done.
 
'''6.''' Use the following account data to get access to the SVN 'repository' (server):
 
User:    oac_read_only
Password: oac_read_only
 
'''7.''' Select YES to create new folder. Click the OK button in the initial download (checkout) overview.
 
'''8.''' The result should look like on [http://www.proper.armaholic.eu/download/oac/images/oac_svn_checkout_done.jpg this image] [[Image:Image icon.png|20 px]] with some files in the '''ofp_compatibility_addon''' folder and <br>little green icons.
 
 
 
====Download latest version from the server====
 
Now every time you want to work on the compatibility addon, make sure to get
the latest version<br>
from the SVN server first.
 
'''1.''' RMB click on the '''ofp_compatibility_addon folder''' and select [http://www.proper.armaholic.eu/download/oac/images/oac_svn_update_dialog.jpg SVN Update] [[Image:Image icon.png|20 px]].
 
'''2.''' The software will contact the SVN server and download updates if available. In case there were<br>
updates by other people, you can see the list of changed files in the [http://www.proper.armaholic.eu/download/oac/images/oac_svn_update_completed.jpg update dialog] [[Image:Image icon.png|20 px]].
 
'''3.''' You can click on the '''Show log''' button to find out about the details to what has been changed.
 
'''4.''' In the [http://www.proper.armaholic.eu/download/oac/images/oac_svn_log.jpg Log messages] [[Image:Image icon.png|20 px]] dialog, you can see the different updates.<br>
Each upload of any user, increments the 'revision number'. The revision number is global for the<br>
whole repository. So there is NO revision number for each file like in CVS.
 
Now you can select the different revisions and see the according '''commit comment''' in the<br>
middle and the list of changed files in the given revision at the bottom.
 
Commit comments is done by an author for each commit. They are '''very important''' to<br>
summarize the changes of a revision for all the other people involved!
 
If you RMB click on a file at the bottom, you can select '''Show changes''' to get a [http://www.proper.armaholic.eu/download/oac/images/oac_svn_diff.jpg new dialog] [[Image:Image icon.png|20 px]] that<br>
shows you the code changes from this one revision in detail.
 
 
 
====Follow SVN changes with trac timeline====
 
Using SVN log doesn't work that seamless unfortunately.<br>
Instead you are very much recommended to use the [http://trac.assembla.com/project-oac/timeline OAC trac timline].<br>
 
The timeline is a viewer on the SVN revision history. The main page lists all the updates on the<br>
SVN server. A trac changeset is the same entity as a SVN revision.<br>
The trac [http://trac.assembla.com/project-oac/changeset/1 changeset] (better example needed) is similar to the SVN 'diff' and shows your the<br>changes in the code very well by the nice code coloring.
 
 
====Upload changes to the server====
 
[http://www.proper.armaholic.eu/download/oac/images/oac_svn_commit_option.jpg 1] [[Image:Image icon.png|20 px]]
 
[http://www.proper.armaholic.eu/download/oac/images/oac_svn_commit_dialog.jpg 2] [[Image:Image icon.png|20 px]]
 
[http://www.proper.armaholic.eu/download/oac/images/oac_svn_diff.jpg 3] [[Image:Image icon.png|20 px]]
 
 
 
====Coding standards====
 
* Get a proper text editor like [http://notepad-plus.sourceforge.net/uk/site.htm notepad++] or [http://www.editpadpro.com/ editpadpro].
 
* Do not mess up the code:
** Preceding tabs - NO spaces! - before the code.
** Correct number of preceding tabs.
** NO tabs or spaces at the end of the line.
** Spaces around an equal sign are standard.
** Do not forget a semicolon to end definitions.
** Use quotes for strings.
** Correct placement of brackets.
 
* Use comments where they are meaningful.
 
* Use empty lines to separate code.
 
* Order lists alphabetically - use editor functions!
 
 
 
====Config structure and tricks of the compatibility addon====
 
*
 
==Support need here==
 
* Nice banner for the project.
* Promotion screenshots.
* Promotion trailers.
* Look for '''MISSING''' tag on this page.
 
 
 
==Project team==


Add yourself if you want to contribute.
Add yourself if you want to contribute.
Line 487: Line 232:
* Members:
* Members:
** kju (project manager)
** kju (project manager)
** The-F (island conversion)
** luemmel (campaign testing and promotion)
** Mopar (campaign testing, campaign & mission conversion)
** Raptor (page designer)
** Snake Man (campaign & mission conversion)
** stun (campaign testing and polishing)
** the-f (island conversion)
** Yoma (Yoma Addon Sync developer)


* Contact:
* Contact:
** [mailto:MISSING MISSING E-Mail]
** Mail: [mailto:kju@dev-heaven.net kju@dev-heaven.net]
** Skype group chat room: '''OAC Project: Skype group'''<br>Send Q in the BI forum a [http://www.flashpoint1985.com/cgi-bin/ikonboard311/ikonboard.cgi?act=MSS;CODE=04;MID=81-1010151515 PM] with your skype account to get access
** Account @ dev-heaven.net: {{Link|link= http://dev-heaven.net/account/show/4|text= kju}}
 
** {{Link|link= http://dev-heaven.net/projects/show/oac|text= project page}}
==Project links==
 
* Page:
** [http://www.proper.armaholic.eu/download/oac OAC project page]


* Bugtracker:
** [http://oac.6thsense.eu/mantis/main_page.php OAC mantis]


* SVN changelog:
== Project links ==
** [http://trac.assembla.com/project-oac/timeline OAC trac timeline]


* News:
* {{Link|http://oac.armaholic.eu|Project page}}
** [http://www.flashpoint1985.com/cgi-bin/ikonboard311/ikonboard.cgi?act=ST;f=69;t=74341;st=0 BI forum thread]
* {{Link|link= http://dev-heaven.net/projects/oac/boards|text= Forum}}
* {{Link|link= http://dev-heaven.net/projects/oac/issues|text= Bugtracker}}
* {{Link|link= http://dev-heaven.net/projects/activity/oac|text= Activity view}}
* {{Link|link= http://dev-heaven.net/projects/roadmap/oac|text= Project roadmap}}
* {{Link|link= http://dev-heaven.net/projects/oac/news|text= News}}
* {{Link|link= http://forums.bistudio.com/showthread.php?t=68736|text= BI forum thread}}

Latest revision as of 23:09, 20 November 2023

Banner biki.jpg

by the OAC Project Team


Project info

Welcome to the OAC project - namely OFP ArmA Conversion.

Purpose of the OAC project

  • Playable content. Now. Much. Enjoyable. Good quality.
  • In the form of: Get any OFP missions or campaigns playable in ArmA with little or no
    modification of the mission file.
  • Possibility to use community made addons alongside to improve the visual aspects,
    sounds or gameplay.
  • Easy access to the content.
  • Automated update and delivery system.
  • Open system, focus on compatibility with community addons and MODs.
  • Open source project - every can contribute very easily.


NOT the purpose

  • Make custom models, textures, sounds.
  • Convert (OFP) models to ArmA.
  • Change the gameplay itself.


Cooperation

CWR MOD

The goal from CWR is to recreate the whole OFP CWC experience, based on OFP elite XBOX version.

Project OAC is fully compatible to CWR and OAC makes it possible to run any OFP mission with CWR.
So OAC can act as an supplement to CWR.
Project OAC uses plain ArmA as a base for models, sounds and graphics.

CWR and OAC are sharing their development progress on the CWC and RES campaign.
In addition to that both work closely together on the config part to ensure full compatibility.

Up until today the major difference between both is that OAC is aiming for open development, easy
contribution and iterative development with as many releases as possible whereas CWR relies on few
releases to ensure top quality from the start.


Open source project

The basic idea is that everything is easily accessible for anyone.

In extension to that anyone interested can contribute in different ways to the project.

For example by

  • improving this wiki page
  • reporting bugs on the missions or the addons
  • try new missions and see if they mission file needs to be updated
  • convert missions themselves and add them to the public hub
  • improve the compatibility addon yourself by adding new class mappings of yet missing
    OFP addons or MODs.

To support this process the project heavily relies on tools that support collaboration.

The wiki, git, automated build scripts and Yoma Addon Sync for project and mission delivery.

Only a very loose organization will keep the project on track and ensure the
quality and success of the project.


So overall it will be an easy access and easy to contribute focus to deliver
content as easily and as much as possible!


Support OAC

OAC is an open project that invites you and anybody to contribute. Here is a brief overview of possible ways:

  • Promotion screenshots.
  • Promotion trailers.
  • Campaign testing.
  • Mission makers polishing conversions.
  • Improve the compatibility addon.
  • Convert campaign and missions.

See the contact area, if you need advice.


How does it work

Technical details - skip if not interested.

You cannot run OFP missions or campaigns out of the box in ArmA for a few technical reasons.
Actually it is quite simple to solve these.

Foremost it is about the missing units (classes).
The other problem is that the script syntax change a bit from OFP to ArmA
(strict string-code requirement).


The solution.

For the first problem only a simple compatibility addon is needed the maps the missing classes
to existing ArmA classes.
With a few simple config tricks it also auto embeds models missing in plain ArmA like the
Bradley if the community addon is loaded alongside.

For the CWC and Res campaign and mission a few additional content addons come
along that contain the music, speech files and similar content.

Now this approach is not limited to BI content, yet the starting version also
allows to load WGL5 missions or campaign conversions and it is easily expandable
to virtually any other OFP addon or MOD.


Most missions that do not involve much scripting can already be loaded with only the
compatibility addon.

For missions that do not work out of the box there is an almost completely
automated process to convert any mission to ArmA scripting standards in a few seconds.
The process already works very well, yet it is easily expandable if necessary.

Last very rare and 'complicated' problems can easily be fixed by hand by any fair scripter.

The seven roads to OAC

Please always refer to the FAQ first in case of questions and unclear parts.


# I. Consumer

Not meant in a negative way. Simply plays the missions and campaigns provided.
Silent epicure.

Details: Download and play.


# II. Promoter

Tells his mates or other people about the project. Given he likes it of course. :)

Details: Promote OAC and tell us about it.

# III. Feedback

Shares his opinion about the project.
Makes suggestions how to improve any aspect of the project.
Suggests missions or campaigns for conversion.
Suggests OFP addons or MODs to be included in the compatibility addon.

Details: Where to post feedback.


# IV. Bugreporting

Reports bugs in converted missions or campaigns or bugs in the compatibility
addon itself at the bugtracker in a decent way (steps to reproduce, arma.rpt
error, screenshots/videos of the problem).

Details: Where to post bugs.


# V. Contributer

Helps to improve the wiki page.
Makes screenshots or videos to promote the project.
Helps maintaining the infrastructure of the project (source repository, build process, YAS server, issuetracker).
Supports the project with infrastructure.

Details: How to contribute.

# VI. Missions converter

Either you help to improve already converted missions or campaigns by fixing bugs
or improving the gameplay by altering the mission file itself to a limited degree.
Or you convert new missions or campaigns yourself and add them to the public sharing system.

Details: How to convert missions and share.


# VII. Core developer

You are already into config editing or want to learn something about it.
If so, this one is for you.
You can either improve the existing compatibility addon by improving the class
mapping in different ways or add new mappings for yet missing OFP addons or MODs.


Details: How to improve the compatibility addon.


Subpage link overview

Our earnest thanks

to our hosts:

  • Page (dead link) hosted by armaholic (dead link): made by Raptor.
  • Forum (dead link) hosted by dev-heaven.net (dead link).
  • Source repository (dead link) hosted by dev-heaven.net (dead link).
  • Issue tracker (dead link) Redmine hosted by dev-heaven.net (dead link).
  • Yoma Addon Sync 2009 (dead link) hosted by quest-link.net.

to individuals

  • armaholic team (dead link) for hosting our page and projects!
  • Sickboy (dead link) for hosting OAC @ dev-heaven.net!
  • MadDogX for hosting the OAC YAS server!
  • Yoma for ongoing development and support of Yoma Addon Sync (dead link)!
  • Raptor for designing the excellent OAC project page, OAC banner and setting up the OAC forum!
  • The-f for the ACEIP island conversion!
  • stun for play testing the CWC campaign and many fixing issues in the process!
  • Mopar for campaign testing, his campaign & mission conversions!
  • luemmel for campaign testing, promotion and his mission conversions!
  • Snake Man for his campaign & mission conversions!
  • SLAYER RF for his p85 replacement configs!


Project team

Add yourself if you want to contribute.

  • Members:
    • kju (project manager)
    • luemmel (campaign testing and promotion)
    • Mopar (campaign testing, campaign & mission conversion)
    • Raptor (page designer)
    • Snake Man (campaign & mission conversion)
    • stun (campaign testing and polishing)
    • the-f (island conversion)
    • Yoma (Yoma Addon Sync developer)
  • Contact:
    • Mail: kju@dev-heaven.net
    • Account @ dev-heaven.net: kju (dead link)
    • project page (dead link)


Project links

  • Project page (dead link)
  • Forum (dead link)
  • Bugtracker (dead link)
  • Activity view (dead link)
  • Project roadmap (dead link)
  • News (dead link)
  • BI forum thread