Marauroa on Eclipse

• General Information
  • Overview
  • What is Marauroa?
  • Features
  • Glossary
  • Differences
  • History
  • New in Marauroa 3.8
  • New in Marauroa 3.9
• Using Marauroa
  • Building
  • Initial Steps
  • Tutorial
  • Core API
  • Adventure Games Concepts
  • Database Access
  • server.ini
  • Testserver
• Internals
  • Network Design
  • Role Playing Design
  • Database Design
  • Database Access
  • Eclipse
  • Roadmap
  • JUnit

First Steps (Installing EGit Plugin)

In Eclipse check if you have got Eclipse EGit already installed:

* Help -> Install New Software... -> What is already installed?
* Now you should have opened a Window titled "Eclipse Intallation Details".
* Look for Eclipse EGit in the list of installed Software.

If you don't see Eclipse EGit in that list:

* Close (go back to the Window titled "Install") -> Work with: <your Eclipse version> 
  (e. g. Indigo - http://download.eclipse.org/releases/indigo)
* Into the filter text box type "egit".
* Eclipse EGit should come up (on the Collaboration branch).
* Mark Eclipse EGit by clicking the small box next to it.
* Click Next and follow through clicking Next until finished. 
* Restart Eclipse when prompted.

Getting Marauroa Source from Git

Once installed the Eclipse EGit software you can proceed preparing Eclipse for your sourceforge git access.

Configuration

* First you need to tell Git about yourself: 
  Window -> Preferences -> Team -> Git -> Configuration
* Click New Entry and enter 
  Key: user.name
  Value: <your sourceforge username>
* Click New Entry again and enter
  Key: user.email
  Value: <your sourceforge email address> (<your sourceforge username>@users.sourceforge.net)

This information is stored in ~/.gitconfig (Linux) or %USERPROFILE%\.gitconfig (Windows) and will be used by Git to identify who did change the history of the repository.

You'll see the location of the file right above the key table in the window you are looking at. Click [Open] and edit it directly in Eclipse. Add the rest of the file as in the example below. (Replace USERNAME with your sourceforge username.)

[core]
	repositoryformatversion = 0
	filemode = true
	logallrefupdates = true
	autocrlf = false
[branch "master"]
	remote = origin
	merge = refs/heads/master
[remote "origin"]
	url = ssh://USERNAME@arianne.git.sourceforge.net/gitroot/arianne/marauroa.git
	fetch = +refs/heads/*:refs/remotes/origin/*
[user]
	name = USERNAME
	email = USERNAME@users.sourceforge.net

Before going on, you possibly might want to change the default repository folder to be sure the new project will be stored into your Eclipse workspace:

* Window -> Preferences -> Team -> Git
  Default repository folder: <your Eclipse workspace folder>

Get Code

* File -> Import... -> Git -> Projects from Git -> Next
* Clone...
  URI: ssh://USERNAME@arianne.git.sourceforge.net/gitroot/arianne/marauroa.git
  (changing USERNAME to your own source forge username)
  User: <your sourceforge username>
  Password: <your sourceforge password>
  Store in Secure Store: Select that if you want
* If you have trouble at this stage try restarting eclipse and try again
* Select all branches if not already selected (fast anyway) -> Next
  Initial branch: master 
  Remote name: origin
  (should already be inserted)
* Let it import everything
* Select the repository you just cloned -> Next
* Wizard for project import: Use the New Projects wizard -> Finish
* New Project wizard will open
* Select Java -> Java Project -> Next
* Give it a name (marauroa will do)
* The other defaults are okay
* Finish

While perferforming the ssh connect you will be asked to accept a fingerprint of the server. Please validate that against the Sourceforge Fingerprint Listing

Trouble Shooting

menu Windows | Preferences | Java | Installed JREs

• there should be at least one entry with a valid JAVA_HOME path

See also

Stendhal on Eclipse
Arianne Source Code Repositories {{#breadcrumbs: Marauroa | Internals | Marauroa on Eclipse }}