Sierra Version Tool: Difference between revisions

From Sierra Wiki
Jump to navigationJump to search
Andrew Branscom (talk | contribs)
No edit summary
Tag: Manual revert
Andrew Branscom (talk | contribs)
No edit summary
 
(37 intermediate revisions by the same user not shown)
Line 1: Line 1:
<div align="center"><div style="font-size: 22pt">Sierra Version Tool</div><br />
<div align="center"><span style="font-size: 22pt">Sierra Version Tool</span><br />''Version 1.1''<br />''Author: [[Andrew Branscom]]''<!--<br />''Developer ''--><br />''2023-02-23''</div></div>
Version 1.1<br />''Author: [[Andrew Branscom]]''<br />2023-02-23</div>
{{TechToolStub}}


{{FanSoftwareInfobox
{{FanSCISoftwareInfobox
| Software = Sierra Version Tool
| Software = Sierra Version Tool
| Image = [[Image:SierraVersionToolSS.png|190px]]<br />
| Image = [[Image:SierraVersionToolSS.png|190px]]<br />
''Sierra Version Tool<br />''Screenshot
''Sierra Version Tool<br />''Screenshot
| Version = 1.1
| Version = 1.1
| ReleaseDate = {{2023}}-02-23<ref>https://sciprogramming.com/community/index.php?topic=2116.0</ref>
| ReleaseDate = {{2023S}}-02-23<ref>[https://sciprogramming.com/community/index.php?topic=2116.0 sierrahelp.com]</ref>
| Company = {{SHPTool}}
| Company = {{SHPTool}}
| DevStatus = {{ActiveDev}}
| DevStatus = {{ActiveDev}}
| Published = {{Published}}
| Published = {{Published}}
| Developers = {{AndrewBranscomToolDev}}
| Developers = {{AndrewBranscomToolDev}}{{ColdTurkeyToolC}}{{JeremiahNellisToolC}}
| Interface = {{GUI}}
| Interface = {{GUI}}
| ProgLanguage = {{CSharp}}
| ProgLanguage = {{CSharp}}
| OpenSource = {{ClosedSRC}}
| OpenSource = {{OpenSRC}}
| Source = {{NoSourceSW}}
| Source = {{NoSourceSW}}
| License = {{GNU}}
| License = {{GPL3}}
| Type = {{Cataloger}}, {{VersionDetectorTool}}
| Type = {{FanCataloger}}, {{FanVersionDetector}}
| Engine = {{AGITool}}, {{GOBTool}}, {{LSCITool}}, {{SCITool}}
| Engine = {{3SpaceTool}}, {{ADLTool}}, {{AGITool}}, {{DGDSTool}}, {{GALTool}}, {{GOBTool}}, {{LSCITool}}, {{SCITool}}
| Platform = {{WinTool}}
| Platform = {{WinTool}}
| Localization = {{EnglishTool}}
| Localization = {{EnglishTool}}
| Website = [[SHP:|sierrahelp.com]]
| Website = [[shp:|sierrahelp.com]]
}}
}}


Line 35: Line 33:
{{Quote|Attrib = README.md<ref>From the project's README.md</ref>
{{Quote|Attrib = README.md<ref>From the project's README.md</ref>
}}
}}
Andrew Branscom's Sierra Version Tool is a browsable tool that returns release information for AGI and SCI games. It can create a text file with the inforrmation gleaned for cataloging and archival purposes
Andrew Branscom's Sierra Version Tool is a browsable tool that returns release information for Sierra games. It can create a text file with the information gleaned for cataloging and archival purposes.
 
The Sierra Version Toolt makes use of the original AGIChecker and SCIChecker classes written by Cold Turkey. It uses a database based on HWM's Sierra version list with hashes from the ScummVM AGI and SCI detection_tables.h.  
</div>
</div>
<blockquote>
The Sierra Version Tool is currently maintained by Andrew Branscom
</blockquote>


===<br /> Screenshots ===
===<br /> Screenshots ===


{| align="center" width="80%"
<div align="center">
| align="center"|[[Image:SierraVersionToolSS1.png|320px]]
<gallery widths=320  heights=246 mode="nolines">
| align="center"|[[Image:SierraVersionToolSS2.png|320px]]
Image:SierraVersionToolSS1.png|Tools Menu
|}
Image:SierraVersionToolSS2.png|Unknown Release Submission Editor
</gallery>
</div>


==<br /> Features ==
==<br /> Features ==


<blockquote>
The Sierra Version Tool includes a few handy tools.
The Sierra Version Tool includes a few handy tools.


* Hash Generator
* Hash Generator
* AGI CPC Decryptor
* DOSBox Launcher
* DOSBox Launcher
* DOSBoxECE (Enhanced Community Edition)
* [[AGILE]], a modern AGI interpreter
* [[AppleWin]], the AppleII emulator
* [[github:otya128/winevdm|WineVDM]]
The hash generator can be used to determine the MD5 of a key game file for unrecognized games. The generated hash can be used to submit determined information for the database. Go to "Tools" > "Get Hash" and select your key file. This is usually the "[[LOGDIR]]" file for AGI games and [[RESOURCE.MAP]] or the first of the RESOURCE.00* files for SCI games. This will copy the file name and MD5 to the clipboard so you can easily paste it into any notes to report a game missing from the game database.
The DOSBox Launcher can launch a PC AGI or SCI game to check the game's about information. You can select the copy of DOSBox you wish to use by going to "Tools" > "Options" and browse to your installed DOSBox executable. You can select the game's executable and any needed arguments from this dialog, too. This is intended to be a convenience for gathering any missing game information, not a generic DOSBox frontend. Please note that the use of DOSBox may result in stdout.txt and stderr.txt files to be written to the game's folder. Please see the "Important Note" section above before using this feature.
The Sierra Version Tool ships with a copy of DOSBoxECE, an enhanced build of DOSBox for running and querying a game for additional information.


The hash generator can be used to determine the MD5 of a key game file for unrecognized games. The generated hash can be used to submit determined information for the database. Go to "Tools" > "Get Hash" and select your key file. This is usually the "LOGDIR" file for AGI games and RESOURCE.MAP or the first of the RESOURCE.00* files for SCI games. This will copy the file name and MD5 to the clipboard so you can easily paste it into any notes to report a game missing from the game database.
Agile is a modern AGI Windows interpreter that is not affected by the infamous CPC disk copy protection of early AGI games. It allows running and querying AGI games for additional information.


If the selected game is an AGI game with the infamous CPC "bad disk track" copy protection, Cold Turkey's AGI DiskFree Decryptor is included to allow the selected game to be decrypted so it can be played on modern PCs. It will generate an "AGI.EXE" file to launch the game without low level access to the key disk. This does not alter any of the game's files, but be sure to read the "Important Note" section above before using this feature. To decrypt the currently selected game go to "Tools" > "Decrypt AGI game".
To query Apple II games, the AppleWin emulator is included.
WineVDM allows running and querying Win16 SCI games for interpreter flags and exploring ingame menu information on x64 Windows.


The DOSBox Launcher can launch a PC AGI or SCI game to check the game's about information. You can select the copy of DOSBox you wish to use by going to "Tools" > "Options" and browse to your installed DOSBox executable. You can select the game's executable and any needed arguments from this dialog, too. This is intended to be a convenience for gathering any missing game information, not a generic DOSBox frontend. Please note that the use of DOSBox may result in stdout.txt and stderr.txt files to be written to the game's folder. Please see the "Important Note" section above before using this feature.
Additional features include built-in search links to research your game. For any unknown games you might encounter there is a Submissions Editor to gather and submit hash and version info to the developer to add the game to the Sierra Version Tool's database.
</blockquote>


==<br /> Requirements ==
==<br /> Requirements ==


<blockquote>
<blockquote>
<!-- Add requirements here -->
4.8 .NET runtime
</blockquote>
</blockquote>


Line 79: Line 87:


<blockquote>
<blockquote>
Sierra Version Tool is currently under active development.
The Sierra Version Tool is currently under active development. It is maintained by Andrew Branscom
</blockquote>
</blockquote>


Line 88: Line 96:
</blockquote>
</blockquote>


<div id="DL">
==<br /> Download ==
==<br /> Download ==


Line 102: Line 111:


* [[Andrew Branscom]]
* [[Andrew Branscom]]
<blockquote>
===<br /> Acknowledgements ===
<blockquote>
* [[Cold Turkey]]
* [[Jeremiah Nellis]]
* [[HWM]]
The Sierra Version Tool makes use of the original AGIChecker and SCIChecker classes written by Cold Turkey. It uses a database based on HWM's Sierra version list with hashes from the [[ScummVM]] AGI and SCI detection_tables.h. The SCI version detection method adapted from Jeremiah Nellis's DetectSCI class.
</blockquote>
</blockquote>
==<br /> Legal ==
Sierra Version Tool was distributed with the {{GPL2}}


==<br /> References ==
==<br /> References ==
Line 109: Line 134:
==<br /> Also See ==
==<br /> Also See ==


* [[:Category:Collecting|Collecting Articles]]
* [[:Category:Catalogers|Catalogers]]
* [[:Category:Catalogers|Catalogers]]
* [[:Category:Version Detectors|Version Detectors]]
* [[:Category:Version Detectors|Version Detectors]]
* [[:Category:Archiving Articles|Archiving Articles]]
* [[:Category:Archiving Utilities|Archiving Utilities]]
* [[:Category:Version Detectors|Version Detectors]]
* [[:Category:Catalogers|Catalogers]]
* [[shp:|sierrahelp.com]]
* [[shp:|sierrahelp.com]]
&nbsp;
&nbsp;
[[Category:References]]
[[Category:Technical Info]]
[[Category:Technical Info]]
[[Category:AGI Technical Info]]
[[Category:Historical Pages]]
[[Category:GOB Technical Info]]
[[Category:Interpreter Articles]]
[[Category:LSCI Technical Info]]
[[Category:Collecting]]
[[Category:SCI Technical Info]]
[[Category:Catalogers]]
[[Category:References]]
[[Category:Cataloging]]
[[Category:AGI References]]
[[Category:Archiving]]
[[Category:GOB References]]
[[Category:Interpreter Articles]]
[[Category:LSCI References]]
[[Category:Software Suites]]
[[Category:SCI References]]

Latest revision as of 19:49, 7 July 2026

Sierra Version Tool
Version 1.1
Author: Andrew Branscom
2023-02-23
Sierra Version Tool

Sierra Version Tool
Screenshot
Latest Version:  1.1
Release Date:  2023-02-23[1]
Company: SHP
Development Status:  Active
Publication Status:  Published
Developer(s): Andrew Branscom
Interface: GUI
Language: C#
Open Source: Open
Source Availability:  No
License: GPL3
Type: Cataloger, Change to FanVerDetector
Relevant Engine: 3Space, ADL, AGI, DGDS, GAL Tool, GOB, LSCI, SCI
Platform: Windows
Localization: English
Website: sierrahelp.com




A.K.A.

  • SVT


Description

README.md[2] wrote:

Andrew Branscom's Sierra Version Tool is a browsable tool that returns release information for Sierra games. It can create a text file with the information gleaned for cataloging and archival purposes.


Screenshots


Features

The Sierra Version Tool includes a few handy tools.

  • Hash Generator
  • DOSBox Launcher
  • DOSBoxECE (Enhanced Community Edition)
  • AGILE, a modern AGI interpreter
  • AppleWin, the AppleII emulator
  • WineVDM

The hash generator can be used to determine the MD5 of a key game file for unrecognized games. The generated hash can be used to submit determined information for the database. Go to "Tools" > "Get Hash" and select your key file. This is usually the "LOGDIR" file for AGI games and RESOURCE.MAP or the first of the RESOURCE.00* files for SCI games. This will copy the file name and MD5 to the clipboard so you can easily paste it into any notes to report a game missing from the game database.

The DOSBox Launcher can launch a PC AGI or SCI game to check the game's about information. You can select the copy of DOSBox you wish to use by going to "Tools" > "Options" and browse to your installed DOSBox executable. You can select the game's executable and any needed arguments from this dialog, too. This is intended to be a convenience for gathering any missing game information, not a generic DOSBox frontend. Please note that the use of DOSBox may result in stdout.txt and stderr.txt files to be written to the game's folder. Please see the "Important Note" section above before using this feature.

The Sierra Version Tool ships with a copy of DOSBoxECE, an enhanced build of DOSBox for running and querying a game for additional information.

Agile is a modern AGI Windows interpreter that is not affected by the infamous CPC disk copy protection of early AGI games. It allows running and querying AGI games for additional information.

To query Apple II games, the AppleWin emulator is included.

WineVDM allows running and querying Win16 SCI games for interpreter flags and exploring ingame menu information on x64 Windows.

Additional features include built-in search links to research your game. For any unknown games you might encounter there is a Submissions Editor to gather and submit hash and version info to the developer to add the game to the Sierra Version Tool's database.


Requirements

4.8 .NET runtime


Version History


Development Status

The Sierra Version Tool is currently under active development. It is maintained by Andrew Branscom


Options


Download

Download from here:


Known issues

  • The Sierra Version Tool can write files to the selected game path if you have it write a "Version.txt" file or use the AGI CPC Decryptor. It is recommended that you copy the contents of the game disk(s) to a folder on your hard drive as you should not alter an original game disk by writing to it. This diminishes the archival value of the disk.


Credits


Acknowledgements

The Sierra Version Tool makes use of the original AGIChecker and SCIChecker classes written by Cold Turkey. It uses a database based on HWM's Sierra version list with hashes from the ScummVM AGI and SCI detection_tables.h. The SCI version detection method adapted from Jeremiah Nellis's DetectSCI class.


Legal

Sierra Version Tool was distributed with the GPL2


References

  1. ↑ sierrahelp.com
  2. ↑ From the project's README.md


Also See