...
- After having installed the plug-in, a new 'GOAL Perspective' is now available. Switch Eclipse to this perspective for the first time through 'Windows -> Open Perspective -> Other -> GOAL'. A shortcut will be placed in the top-right corner.
- We recommend changing the following preferences in Eclipse ('Window > Preferences'):
- General > Workspace > : (1) Refresh using native hooks or polling > Enable (2) Text file encoding > Other: UTF-8.
- Install/Update > Automatic Updates > Automatically find new updates and notify me > Enable.
- Run/Debug > Console > Console buffer size (characters) > Set to 999999 (the maximum).
Please note that if you are having performance issues whilst debugging, e.g. with many agents, the console buffer size can be reduced. The consoles for each agents and/or the action history can even be entirely disabled in the 'GOAL > Logging' preference category, where the logging itself can be fully tweaked as well.
...
- Create a new GOAL project through: 'File > New > GOAL Project'. You can also right-click in the 'Script Explorer' to get the same 'New' menu. Enter a project name in the following dialog, and optionally select an existing environment file (.jar) to automatically import into the project. A mas2g file (optionally containing a reference to the specified environment file) will be automatically created in the new project.
- Import an existing GOAL project through 'File > Import > GOAL Agent Programming > Existing GOAL Project'. Select the relevant mas2g file in the next step, and optionally copy the files into your workspace (the default is just to create a link to them).
- Create a new file by either using 'File > New' or 'Right-click on your project in the Script Explorer > New'. In the resulting menu, you can select any of the relevant types to create (.goal agent, .mod2g module, .act2g actionspecification .pl knowledge representation, .test2g test, .mas2g MAS, folder), after which you will be asked for a name.
...
- Any errors and warnings will be displayed at their actual location (red or yellow underline). A marker will also be placed in the sidebar, and an item will be added to the 'Problems' tab at the bottom. Please note that for full validation of external files (.mod2g or .pl), their parent agent file (.goal) will have to be savedA full (MAS-level) validation will be performed when saving any file (as opposed to local checks whilst editing).
- Auto-complete is available through the default 'CTRL+Space' keyboard shortcut.
- Comments above predicates will be processed and available throughout the file when hovering the on a predicate with the same name.
- A browseable outline of the current file (in which warning or error markers are also shown) is available in the bottom-left corner.
- Blocks of code or comments can be folded by using the controls (+/-) in the editor's sidebar.
...
Note that we have a Q&A site available at https://goalapl.atlassian.net/wiki/display/GOAL/questions/all. We also have a GOAL Service Desk (requires registration first). The developer of this plug-in can also be reached at v.j.koeman@tudelft.nl Please try the following steps firstfollowing steps troubleshoot most problems:
- Reset the GOAL and/or GOAL Debug perspective(s) by selecting 'Window > Reset Perspective' when the perspective is opened.
- Restore the default GOAL preferences through 'Window > Preferences > GOAL > Logging > Restore Defaults > Apply', and do the same for the 'Runtime' category.
- Follow the 'First use' section above.
...
For more extensive documentation on the GOAL programming language itself or the use of the Eclipse plug-in (including debugging and testing), see the GOAL Programming Guide and the GOAL-Eclipse User Manual.