ndspy 3.0.0

国家情报局

ndspy（“en dee ESS pie”）是一个Python库和一套命令行 可以帮助您读取、修改和创建在 任天堂DS游戏。

ndspy遵循以下几个关键设计原则：

• 准确度：ndspy应该能够打开和重新保存任何支持的文件 如果是标准格式，则具有逐字节精度。
{STR 1 } $灵活性：NDSPIT应该能够以格式读取任何有效文件 支持。在很有可能无法完全 解释文件中一些特别复杂的部分，它应该仍然有用 用于编辑其他部分
• semantic：ndspy的api应该与文件的语义紧密匹配 结构，同时隐藏其二进制级别的详细信息

ndspy提供了一个python api和一组简单的命令行工具 好好利用它。命令行工具允许您将文件转换为二进制文件 无需自己编写任何Python代码即可格式化API是合适的 在用Python编写的应用程序中使用，并在脚本中执行更复杂的操作 命令行工具无法执行的任务。

由于ndspy是用纯Python编写的，它是跨平台的，应该在所有 python支持的平台。注意python不支持任天堂ds 它本身；ndspy打算在您的电脑上使用。

有兴趣吗？继续阅读以查看一些示例，或者检查API Reference以查看 特定模块的文档。准备好安装后，请转到 是Installation部分！

ndspy的几个实际例子

创建包含消息字符串的BMG文件：

>>>importndspy.bmg>>>message1=ndspy.bmg.Message(b'',['Open your eyes...'])>>>message2=ndspy.bmg.Message(b'',['Wake up, Link...'])>>>bmg=ndspy.bmg.BMG.fromMessages([message1,message2])>>>bmg.save()b'MESGbmg1\xa0\x00\x00\x00\x02\x00\x00\x00\x02\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00INF1 \x00\x00\x00\x02\x00\x04\x00\x00\x00\x00\x00\x02\x00\x00\x00&\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00DAT1`\x00\x00\x00\x00\x00O\x00p\x00e\x00n\x00\x00y\x00o\x00u\x00r\x00\x00e\x00y\x00e\x00s\x00.\x00.\x00.\x00\x00\x00W\x00a\x00k\x00e\x00\x00u\x00p\x00,\x00\x00L\x00i\x00n\x00k\x00.\x00.\x00.\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00'>>>

将sseq序列音乐文件中的所有音符更改为中间c，类似于this song：

>>>importndspy.soundSequence>>>song=ndspy.soundSequence.SSEQ.fromFile('never-gonna-give-you-up.sseq')>>>song.parse()>>>foreventinsong.events:...ifisinstance(event,ndspy.soundSequence.NoteSequenceEvent):...event.pitch=60...>>>song.saveToFile('never-gonna-give-you-up-but-all-the-notes-are-c.sseq')>>>

使用lz10压缩格式压缩和解压缩数据：

>>>importndspy.lz10>>>compressed=ndspy.lz10.compress(b'This is some data to compress')>>>compressedb'\x10\x1d\x00\x00\x04This \x00\x02so\x00me data \x00to compr\x00ess\x00\x00\x00\x00\x00'>>>ndspy.lz10.decompress(compressed)b'This is some data to compress'>>>

搜索ROM中以特定字节序列开头的所有文件：

>>>importndspy.rom>>>rom=ndspy.rom.NintendoDSRom.fromFile('nsmb.nds')>>>fori,fileinenumerate(rom.files):...iffile.startswith(b'BMD0'):...print(rom.filenames[i]+' is a NSBMD model')...demo/end_kp.nsbmdisaNSBMDmodeldemo/staffroll.nsbmdisaNSBMDmodeldemo/staffroll_back.nsbmdisaNSBMDmodelenemy/A_jiku.nsbmdisaNSBMDmodelenemy/all_goal_flag.nsbmdisaNSBMDmodel...map/world7.nsbmdisaNSBMDmodelmap/world8.nsbmdisaNSBMDmodel>>>

误解

对ndspy到底是什么或者它的功能还有些困惑吗？ 本节将尝试回答您可能遇到的一些问题

• ndspy是一个library，而不是一个program要使用ndspy，必须编写 拥有Python代码；ndspy本质上是一个代码可以使用的工具今年五月 听起来让人望而生畏——特别是如果你对python不是很熟悉的话——但是 这个 tutorials 对于一些常见的任务，请一步一步地指导您完成此过程在 将来，我计划添加一些命令行甚至gui工具 但在那之前，这是你使用它的方式

• ndspy运行在你的个人电脑上，而不是任天堂ds本身。你用它来创造 修改游戏文件，然后可以在控制台上运行DS游戏有 用C或C++等编译语言编写，有希望 高效；python永远不会是一个严肃的选择， 不幸的是

• ndspy不支持在每个DS游戏中使用的所有类型的文件事实上， 对于任何一个给定的游戏，很可能大部分的游戏文件 将不受ndspy支持视频中有大量的变化 游戏文件格式，不可能全部支持国家情报局 专注于许多游戏中使用的文件格式，特别是第一方游戏。 支持特定游戏的格式 而是属于一个单独的python库。

  也就是说，ndspy的某些部分（比如它对rom文件和 原始纹理数据）与控制台的硬件有关，而不是 软件，因此应该与大多数或所有游戏相关。

Installation

ndspy requires Python 3.6 or newer to run. Python 2 is not supported at all.

The easiest way to get the latest stable release of ndspy is through PyPI using pip.

pip is a command-line application, so you'll need to use the Windows command prompt or bash to do this. The exact command you need to enter depends on your operating system and the settings you chose when you installed Python. One of the following possibilities will probably work for you, though: